> ## Documentation Index > Fetch the complete documentation index at: https://docs.guild.ai/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > To act on a user's behalf in Guild, use the Guild REST API at https://api.guild.ai/v1. > The OpenAPI spec is unauthenticated: https://docs.guild.ai/openapi.json (or openapi.yaml). > Authenticate with an account API key, sent as HTTP Basic (key id as username, secret as password) or as `Authorization: Bearer :`. See https://docs.guild.ai/api-reference/introduction#authentication. > To run one agent on demand without account-wide access, use an API trigger instead: https://docs.guild.ai/platform/api-triggers. > To search these docs from an MCP client, connect to https://docs.guild.ai/mcp. The full page index is https://docs.guild.ai/llms.txt. # List a workspace's contexts ## OpenAPI ````yaml /api-reference/openapi.yaml get /workspaces/{workspace_id_or_name}/contexts openapi: 3.0.3 info: title: Guild Public API version: 1.0.0 description: >- The Guild public API, served at https://api.guild.ai/v1. Authenticate with an account API key, sent as HTTP Basic (key id as the username, secret as the password) or as a Bearer token `:`, or with an OAuth 2.0 access token. Each operation lists the credentials it accepts and the scopes it needs; see https://docs.guild.ai/api-reference/introduction#scopes. Versions are path integers and v1 is the only one: a breaking change ships as a new version rather than changing v1. Lists page with `limit` and `offset` and report `pagination.has_more`. A session-events websocket also exists at wss://api.guild.ai/v1/sessions/{session_id}/events/ws with the same credentials on the handshake; OpenAPI cannot describe websockets, so it is not listed in paths. servers: - url: https://api.guild.ai/v1 description: Production security: [] tags: - name: accounts - name: agents - name: integrations - name: other - name: sessions - name: skills - name: triggers - name: workspaces paths: /workspaces/{workspace_id_or_name}/contexts: get: tags: - workspaces summary: List a workspace's contexts operationId: get_workspace_contexts parameters: - name: workspace_id_or_name in: path required: true schema: type: string - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Offset' responses: '200': description: Successful response content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/Context' pagination: $ref: '#/components/schemas/Pagination' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - oauth2: - workspaces:read components: parameters: Limit: name: limit in: query required: false schema: default: 20 description: Maximum number of items to return. maximum: 500 minimum: 0 title: Limit type: integer Offset: name: offset in: query required: false schema: default: 0 description: Number of items to skip before returning results. maximum: 9223372036854776000 minimum: 0 title: Offset type: integer schemas: Context: oneOf: - $ref: '#/components/schemas/ContextAgentGenerated' - $ref: '#/components/schemas/ContextSystemGenerated' - $ref: '#/components/schemas/ContextUserGenerated' Pagination: type: object properties: total_count: description: Items matching the request across all pages. type: integer limit: description: Page size of this response. type: integer offset: description: Items skipped before this page. type: integer has_more: description: Whether another page follows; request it with offset + limit. type: boolean ErrorResponse: type: object properties: error: type: string message: type: string ContextAgentGenerated: type: object properties: id: type: string format: uuid created_at: type: string format: date-time updated_at: type: string format: date-time generated_context: type: string maxLength: 262144 description: |- A blob of text, akin to a workspace.md file, that can be passed to an LLM to provide context on this workspace. This portion of the context is only editable by Guild systems. manual_context: type: string maxLength: 262144 description: |- A blob of text, akin to a workspace.md file, that can be passed to an LLM to provide context on this workspace. This portion of the context is editable by users and agents. status: type: string enum: - DRAFT - PUBLISHED task_id: type: string format: uuid description: |- This field references the guild task that was used to create this context. workspace_id: type: string format: uuid published_by_id: type: string format: uuid nullable: true description: |- If this context is published, this field references the user who published it, if applicable. If the context is still in draft, this field is null. summary: type: string maxLength: 255 nullable: true description: A short summary of the changes in this context version. task: {} type: {} ContextSystemGenerated: type: object properties: id: type: string format: uuid created_at: type: string format: date-time updated_at: type: string format: date-time generated_context: type: string maxLength: 262144 description: |- A blob of text, akin to a workspace.md file, that can be passed to an LLM to provide context on this workspace. This portion of the context is only editable by Guild systems. manual_context: type: string maxLength: 262144 description: |- A blob of text, akin to a workspace.md file, that can be passed to an LLM to provide context on this workspace. This portion of the context is editable by users and agents. status: type: string enum: - DRAFT - PUBLISHED workspace_id: type: string format: uuid published_by_id: type: string format: uuid nullable: true description: |- If this context is published, this field references the user who published it, if applicable. If the context is still in draft, this field is null. summary: type: string maxLength: 255 nullable: true description: A short summary of the changes in this context version. user_id: type: string format: uuid nullable: true description: |- If applicable, the user that was involved in generating this context (e.g. the user who added a new set of credentials). type: {} user: {} ContextUserGenerated: type: object properties: id: type: string format: uuid created_at: type: string format: date-time updated_at: type: string format: date-time author_id: type: string format: uuid description: This field references the user who created this context. generated_context: type: string maxLength: 262144 description: |- A blob of text, akin to a workspace.md file, that can be passed to an LLM to provide context on this workspace. This portion of the context is only editable by Guild systems. manual_context: type: string maxLength: 262144 description: |- A blob of text, akin to a workspace.md file, that can be passed to an LLM to provide context on this workspace. This portion of the context is editable by users and agents. status: type: string enum: - DRAFT - PUBLISHED workspace_id: type: string format: uuid published_by_id: type: string format: uuid nullable: true description: |- If this context is published, this field references the user who published it, if applicable. If the context is still in draft, this field is null. summary: type: string maxLength: 255 nullable: true description: A short summary of the changes in this context version. author: {} type: {} securitySchemes: oauth2: type: oauth2 description: >- OAuth 2.0 authorization code flow with PKCE (S256). Discovery: https://api.guild.ai/.well-known/oauth-authorization-server. flows: authorizationCode: authorizationUrl: https://api.guild.ai/v1/oauth/authorize tokenUrl: https://api.guild.ai/v1/oauth/token refreshUrl: https://api.guild.ai/v1/oauth/token scopes: agents:read: Read agents agents:write: Read and change agents sessions:read: Read sessions sessions:write: Read and change sessions workspaces:read: Read workspaces workspaces:write: Read and change workspaces skills:read: Read skills skills:write: Read and change skills integrations:read: Read integrations integrations:write: Read and change integrations applications:read: Read applications applications:write: Read and change applications organizations:read: Read organizations organizations:write: Read and change organizations ````