{"openapi":"3.1.0","info":{"title":"Guild.ai Public API","version":"1.0.0","description":"This site's own public, unauthenticated endpoints for AI agents integrating with guild.ai (server https://www.guild.ai): an MCP (Model Context Protocol) server for tool-calling access to site content and the demo-request flow, a Markdown renderer for the same content pages agents would otherwise have to scrape as HTML, and a paginated list of blog posts.\n\nVersioning: this site's surface is versioned as a whole rather than per-path, since the endpoints are stable, low-surface-area primitives (a JSON-RPC dispatch, a single renderer, one list) rather than a growing REST resource set. The current version is `info.version`, and every response carries it in the `API-Version` header, so a client can assert on it without refetching this document. A client can also pin a major version by sending the same header on the request (`API-Version: 1`): a request naming a major version the server no longer runs is refused with 400 `unsupported_api_version` rather than served by an incompatible surface. A breaking change bumps the major version; the outgoing operation first gets a `Deprecation` header (RFC 9745) and a `Sunset` header (RFC 8594) naming its removal date, at least 90 days out. Both headers are declared on every response of this site's operations, and `x-api-lifecycle` states the same contract machine-readably. Nothing is deprecated today.\n\nRate limits: every one of this site's endpoints is limited per client IP on a fixed window and reports it on every response except 405 via the `RateLimit-*` headers (draft-ietf-httpapi-ratelimit-headers). Exceeding it returns 429 with `Retry-After`. `/api/mcp` and `/api/posts` allow 60 requests/60s; `/api/markdown` allows 300 requests/60s (it also serves this site's own markdown-negotiated page views, not just direct calls).\n\nPagination: this site's list endpoints are cursor-paginated. Pass `limit` for the page size and the previous response's `next_cursor` as `cursor`; `next_cursor` is `null` on the last page, and a `Link` header with `rel=\"next\"` carries the same URL.\n\nGuild platform API: every path item whose `servers` names https://api.guild.ai/v1 belongs to the Guild platform API, not this site. Those operations are merged in from the API's own document at https://api.guild.ai/v1/openapi.yaml each time this one is served. Three things change on the way: each path item gains that `servers` entry, OpenAPI 3.0's `nullable` becomes a 3.1 `null` type, and an operation with no summary gets one derived from its operationId. Each operation declares the credentials it accepts; most require an API key or an OAuth 2.0 token with the listed scopes. 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 `<key id>:<secret>`, 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.","contact":{"email":"support@guild.ai","url":"https://www.guild.ai/contact"}},"x-api-lifecycle":{"version":"1.0.0","versionHeader":"API-Version","versioningScheme":"whole-surface","requestVersionPinning":"major","deprecationHeader":"Deprecation","sunsetHeader":"Sunset","minimumNoticeDays":90,"deprecatedOperations":[]},"servers":[{"url":"https://www.guild.ai"}],"tags":[{"name":"MCP","description":"Model Context Protocol tool-calling transport."},{"name":"Content","description":"Machine-readable renderings of public content pages."},{"description":"Guild platform API (https://api.guild.ai/v1).","name":"accounts"},{"description":"Guild platform API (https://api.guild.ai/v1).","name":"agents"},{"description":"Guild platform API (https://api.guild.ai/v1).","name":"integrations"},{"description":"Guild platform API (https://api.guild.ai/v1).","name":"other"},{"description":"Guild platform API (https://api.guild.ai/v1).","name":"sessions"},{"description":"Guild platform API (https://api.guild.ai/v1).","name":"skills"},{"description":"Guild platform API (https://api.guild.ai/v1).","name":"triggers"},{"description":"Guild platform API (https://api.guild.ai/v1).","name":"workspaces"}],"paths":{"/api/mcp":{"post":{"operationId":"invokeMcpServer","tags":["MCP"],"summary":"Invoke the Guild.ai MCP server","description":"JSON-RPC 2.0 endpoint for the Model Context Protocol, Streamable HTTP transport. Stateless: every request is a self-contained JSON-RPC call (`initialize`, `tools/list`, `tools/call`, ...). Requires an `Accept` header naming both `application/json` and `text/event-stream`, per the MCP spec. Discover the typed tool catalog at https://www.guild.ai/.well-known/mcp/server-card.json without needing to complete the handshake first.","security":[],"parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major version the client was written against, e.g. `1` (a full version such as `1.0.0` is accepted; only the major part is compared). A request naming any other major version is refused with 400 `unsupported_api_version`. Omit it to accept the current version.","schema":{"type":"string","examples":["1"]}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Opaque client-generated key (max 200 characters) that makes a write tool call safe to retry. Only `tools/call` requests for `request_demo` consult it: replaying the same key with the same arguments within 24 hours returns the original result instead of creating a second lead. Reusing a key with different arguments is refused with an `idempotency_key_reuse` error rather than replayed. Read-only tools ignore the header. Deduplication is per serving instance and best-effort, so treat it as protection against retries, not as a distributed lock.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","description":"MCP JSON-RPC method, e.g. 'initialize', 'tools/list', or 'tools/call'. See https://www.guild.ai/.well-known/mcp/server-card.json for the full typed tool catalog (search_blog, search_pages, get_company_info, compare_guild, request_demo, open_demo_request_form)."},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"A JSON-RPC result or error for the requested method.","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"result":{"type":"object"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}}},"400":{"description":"Malformed JSON, or a body that is not a valid JSON-RPC message, rejected by the transport before dispatch (`JsonRpcError`); or an unsupported `API-Version` (`ApiError`, code `unsupported_api_version`).","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/JsonRpcError"},{"$ref":"#/components/schemas/ApiError"}]}}}},"405":{"description":"Wrong HTTP method. This endpoint only accepts POST.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}}}},"406":{"description":"Missing or incompatible `Accept` header for Streamable HTTP transport.","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcError"}}}},"415":{"description":"Wrong `Content-Type`. The body must be sent as `application/json`.","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcError"}}}},"429":{"description":"Rate limit exceeded for this endpoint. Retry after the given number of seconds.","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds until the rate limit resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/markdown":{"get":{"operationId":"getMarkdownDocument","tags":["Content"],"summary":"Render a public content page as Markdown","description":"Renders the same content the equivalent HTML page shows, as Markdown, for the pages registered for content negotiation (currently: the homepage, top-level marketing pages, and blog posts). HTML pages under content negotiation also serve this representation directly when requested with `Accept: text/markdown`.","security":[],"parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major version the client was written against, e.g. `1` (a full version such as `1.0.0` is accepted; only the major part is compared). A request naming any other major version is refused with 400 `unsupported_api_version`. Omit it to accept the current version.","schema":{"type":"string","examples":["1"]}},{"name":"path","in":"query","required":true,"description":"The site-relative pathname to render, e.g. `/about` or `/blog/news/example`.","schema":{"type":"string"}}],"responses":{"200":{"description":"Markdown rendering of the requested page.","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}}},"content":{"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"`API-Version` names a major version this server does not run (`unsupported_api_version`).","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"The path is not registered for markdown negotiation, or no content exists there.","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}}},"content":{"text/markdown":{"schema":{"$ref":"#/components/schemas/MarkdownErrorDocument"}}}},"405":{"description":"Wrong HTTP method. This endpoint only accepts GET.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}}}},"429":{"description":"Rate limit exceeded for this endpoint. Retry after the given number of seconds.","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds until the rate limit resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"The page is registered but could not be rendered as Markdown.","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}}},"content":{"text/markdown":{"schema":{"$ref":"#/components/schemas/MarkdownErrorDocument"}}}}}}},"/api/posts":{"get":{"operationId":"listPosts","tags":["Content"],"summary":"List blog posts","description":"Public blog posts, newest first, cursor-paginated: the same list as /blog. Each item links the post page and its markdown version.","security":[],"parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major version the client was written against, e.g. `1` (a full version such as `1.0.0` is accepted; only the major part is compared). A request naming any other major version is refused with 400 `unsupported_api_version`. Omit it to accept the current version.","schema":{"type":"string","examples":["1"]}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","required":false,"description":"The `next_cursor` from the previous page. Omit for the first page.","schema":{"type":"string"}}],"responses":{"200":{"description":"One page of posts.","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Link":{"description":"RFC 8288 `rel=\"next\"` link to the next page, when there is one.","required":false,"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostList"}}}},"400":{"description":"Invalid `limit` or `cursor` (`invalid_limit`, `invalid_cursor`), or an unsupported `API-Version` (`unsupported_api_version`).","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"405":{"description":"Wrong HTTP method. This endpoint only accepts GET.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}}}},"429":{"description":"Rate limit exceeded for this endpoint. Retry after the given number of seconds.","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds until the rate limit resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"The post list could not be loaded. Retry after `Retry-After` seconds.","headers":{"API-Version":{"description":"Version of the public API surface that served this response.","schema":{"type":"string","examples":["1.0.0"]}},"Deprecation":{"description":"Present only on a deprecated operation (RFC 9745): the IMF-fixdate the deprecation took effect, as `@`-prefixed seconds or an HTTP-date. Absent means not deprecated.","required":false,"schema":{"type":"string"}},"Sunset":{"description":"Present alongside `Deprecation` (RFC 8594): the HTTP-date the operation stops responding, never sooner than 90 days after the deprecation date.","required":false,"schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/accounts/{account_id_or_name}/budgets":{"get":{"operationId":"get_account_budgets","summary":"List an account's budgets joined with their priced current-cycle spend","tags":["accounts"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["usage:read"]}],"parameters":[{"name":"account_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/accounts/{account_id_or_name}/credentials":{"get":{"operationId":"get_account_credentials","summary":"List an account's integration credentials","tags":["accounts"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["integrations:read"]}],"parameters":[{"name":"account_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"integration","in":"query","required":false,"schema":{"default":null,"description":"Only credentials for this integration, by ID or full name","title":"Integration","type":["string","null"]}},{"name":"search","in":"query","required":false,"schema":{"default":null,"description":"Match against the integration's name","title":"Search","type":["string","null"]}},{"name":"workspace_id","in":"query","required":false,"schema":{"default":null,"title":"Workspace Id","type":["string","null"]}},{"name":"scope","in":"query","required":false,"schema":{"default":null,"title":"Scope","type":["boolean","null"]}},{"name":"network","in":"query","required":false,"schema":{"default":null,"title":"Network","type":["boolean","null"]}},{"name":"grant_candidates","in":"query","required":false,"schema":{"default":null,"title":"Grant Candidates","type":["boolean","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/IntegrationCredentials"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/accounts/{account_id_or_name}/skills":{"get":{"operationId":"get_account_skills","summary":"List an account's skills","tags":["accounts"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["skills:read"]}],"parameters":[{"name":"account_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SortBy"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"search","in":"query","required":false,"schema":{"default":null,"title":"Search","type":["string","null"]}},{"name":"archived","in":"query","required":false,"schema":{"default":null,"title":"Archived","type":["boolean","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Skill"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"create_account_skill","summary":"Create a skill owned by an account","tags":["accounts"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["skills:write"]}],"parameters":[{"name":"account_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Skill name","title":"Name","type":"string"},"overview":{"default":null,"description":"What the skill is for","title":"Overview","type":["string","null"]},"is_public":{"default":false,"title":"Is Public","type":"boolean"},"avatar_url":{"default":null,"title":"Avatar Url","type":["string","null"]}},"required":["name"],"title":"CreateAccountSkillInput","type":"object"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skill"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/accounts/{account_id_or_name}/usage/breakdown/{dimension}":{"get":{"operationId":"get_account_usage_breakdown","summary":"One page of a breakdown (workspaces, agents, users, triggers, platforms, providers, models), sliced from the same cached aggregate as ``/usage/summary``","description":"Same access gate and filters as the summary, plus ``?limit=`` / ``?offset=`` and ``?find=<row key>``, whose index in the full breakdown comes back as ``position``. Users and triggers exist for organization accounts only.","tags":["accounts"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["usage:read"]}],"parameters":[{"name":"account_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"name":"dimension","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"description":"Maximum number of items to return.","maximum":500,"minimum":1,"title":"Limit","type":"integer"}},{"$ref":"#/components/parameters/Offset"},{"name":"days","in":"query","required":false,"schema":{"default":30,"description":"Window in days, ending now","maximum":365,"minimum":1,"title":"Days","type":"integer"}},{"name":"start","in":"query","required":false,"schema":{"default":null,"description":"First day, YYYY-MM-DD; overrides days with end","title":"Start","format":"date","type":["string","null"]}},{"name":"end","in":"query","required":false,"schema":{"default":null,"description":"Last day, YYYY-MM-DD","title":"End","format":"date","type":["string","null"]}},{"name":"provider","in":"query","required":false,"schema":{"default":null,"title":"Provider","type":["string","null"]}},{"name":"model","in":"query","required":false,"schema":{"default":null,"title":"Model","type":["string","null"]}},{"name":"platform","in":"query","required":false,"schema":{"default":null,"title":"Platform","type":["string","null"]}},{"name":"workspace_id","in":"query","required":false,"schema":{"default":null,"description":"Only this workspace, by ID or full name","title":"Workspace Id","type":["string","null"]}},{"name":"agent_id","in":"query","required":false,"schema":{"default":null,"description":"Only this agent, by ID or full name","title":"Agent Id","type":["string","null"]}},{"name":"user_id","in":"query","required":false,"schema":{"default":null,"title":"User Id","type":["string","null"]}},{"name":"find","in":"query","required":false,"schema":{"default":null,"title":"Find","maxLength":200,"type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/accounts/{account_id_or_name}/usage/summary":{"get":{"operationId":"get_account_usage_summary","summary":"Account KPI strip + breakdowns + time series for the Usage page","tags":["accounts"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["usage:read"]}],"parameters":[{"name":"account_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"name":"days","in":"query","required":false,"schema":{"default":30,"description":"Window in days, ending now","maximum":365,"minimum":1,"title":"Days","type":"integer"}},{"name":"start","in":"query","required":false,"schema":{"default":null,"description":"First day, YYYY-MM-DD; overrides days with end","title":"Start","format":"date","type":["string","null"]}},{"name":"end","in":"query","required":false,"schema":{"default":null,"description":"Last day, YYYY-MM-DD","title":"End","format":"date","type":["string","null"]}},{"name":"provider","in":"query","required":false,"schema":{"default":null,"title":"Provider","type":["string","null"]}},{"name":"model","in":"query","required":false,"schema":{"default":null,"title":"Model","type":["string","null"]}},{"name":"platform","in":"query","required":false,"schema":{"default":null,"title":"Platform","type":["string","null"]}},{"name":"workspace_id","in":"query","required":false,"schema":{"default":null,"description":"Only this workspace, by ID or full name","title":"Workspace Id","type":["string","null"]}},{"name":"agent_id","in":"query","required":false,"schema":{"default":null,"description":"Only this agent, by ID or full name","title":"Agent Id","type":["string","null"]}},{"name":"user_id","in":"query","required":false,"schema":{"default":null,"title":"User Id","type":["string","null"]}},{"name":"breakdown_limit","in":"query","required":false,"schema":{"default":null,"description":"Rows to keep in each breakdown, e.g. 5 for the top five","title":"Breakdown Limit","maximum":500,"minimum":1,"type":["integer","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/accounts/{account_id_or_name}/workspaces":{"get":{"operationId":"get_account_workspaces","summary":"List an account's workspaces","tags":["accounts"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:read"]}],"parameters":[{"name":"account_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SortBy"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"archived","in":"query","required":false,"schema":{"default":null,"title":"Archived","type":["boolean","null"]}},{"name":"filter","in":"query","required":false,"schema":{"default":null,"title":"Filter","type":["string","null"]}},{"name":"search","in":"query","required":false,"schema":{"default":null,"title":"Search","type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceList"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}},"x-guild-response-model":"WorkspaceList"},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/agents":{"get":{"operationId":"list_agents","summary":"List and search agents","tags":["agents"],"parameters":[{"$ref":"#/components/parameters/SortBy"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"search","in":"query","required":false,"schema":{"default":null,"description":"Words to match in name or description","title":"Search","type":["string","null"]}},{"name":"fast","in":"query","required":false,"schema":{"default":false,"title":"Fast","type":"boolean"}},{"name":"published_only","in":"query","required":false,"schema":{"default":false,"title":"Published Only","type":"boolean"}},{"name":"is_public","in":"query","required":false,"schema":{"default":false,"title":"Is Public","type":"boolean"}},{"name":"is_pinned","in":"query","required":false,"schema":{"default":null,"title":"Is Pinned","type":["boolean","null"]}},{"name":"for_workspace","in":"query","required":false,"schema":{"default":null,"title":"For Workspace","type":["string","null"]}},{"name":"tags","in":"query","required":false,"schema":{"default":null,"title":"Tags","type":["string","null"]}},{"name":"categories","in":"query","required":false,"schema":{"default":null,"title":"Categories","type":["string","null"]}},{"name":"agent_types","in":"query","required":false,"schema":{"default":null,"title":"Agent Types","type":["string","null"]}},{"name":"owner","in":"query","required":false,"schema":{"default":null,"description":"Owning user or organization, by name or ID. Omit for every agent you can see.","title":"Owner","type":["string","null"]}},{"name":"contributor","in":"query","required":false,"schema":{"default":null,"title":"Contributor","type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Agent"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{},{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}]},"post":{"operationId":"create_agent","summary":"Create an agent","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Agent name, e.g. splunk-fixer","title":"Name","type":"string"},"description":{"default":null,"description":"What the agent does","title":"Description","type":["string","null"]},"is_public":{"default":false,"title":"Is Public","type":"boolean"},"avatar_url":{"default":null,"title":"Avatar Url","type":["string","null"]},"owner_id":{"default":null,"description":"Owning user or organization, by name or ID. Omit for your own.","title":"Owner Id","type":["string","null"]},"maintainer_id":{"default":null,"title":"Maintainer Id","format":"uuid","type":["string","null"]},"category":{"default":null,"title":"Category","type":["string","null"]},"tags":{"default":null,"title":"Tags","items":{"type":"string"},"type":["array","null"]},"forked_from_version":{"default":null,"title":"Forked From Version","format":"uuid","type":["string","null"]},"template":{"default":null,"enum":["LLM","AUTO_MANAGED_STATE","BLANK","GOOSE","GUILD_NATIVE","OPENCLAW","LANGGRAPH","ADK",null],"title":"AgentCreationTemplate","type":["string","null"]}},"required":["name"],"title":"CreateAgentInput","type":"object"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/agents/{agent_id_or_name}":{"get":{"operationId":"get_agent","summary":"Get an agent","tags":["agents"],"parameters":[{"name":"agent_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{},{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}]},"patch":{"operationId":"update_agent","summary":"Update an agent's visibility, archive state or pin","tags":["agents"],"security":[{"oauth2":["agents:write"]}],"parameters":[{"name":"agent_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"properties":{"is_public":{"default":null,"title":"Is Public","type":["boolean","null"]},"is_archived":{"default":null,"title":"Is Archived","type":["boolean","null"]},"is_pinned":{"default":null,"title":"Is Pinned","type":["boolean","null"]},"avatar_url":{"default":null,"title":"Avatar Url","type":["string","null"]},"maintainer_id":{"default":null,"title":"Maintainer Id","format":"uuid","type":["string","null"]},"category":{"default":null,"description":"Category ID or name","title":"Category","type":["string","null"]},"tags":{"default":null,"description":"Tag names; tags other than Guild's need a category","title":"Tags","items":{"type":"string"},"type":["array","null"]}},"title":"UpdateAgentInput","type":"object"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/agents/{agent_id_or_name}/code":{"get":{"operationId":"get_agent_code","summary":"Returns the latest version of this agent's code. Note that by default, it returns only PUBLISHED versions. You can specify ?include_unpublished=true to get the actual latest","tags":["agents"],"parameters":[{"name":"agent_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"name":"include_unpublished","in":"query","required":false,"schema":{"default":false,"title":"Include Unpublished","type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{},{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}]},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/agents/{agent_id_or_name}/configure-llm":{"post":{"operationId":"configure_agent_llm","summary":"Commit a new version of an LLM agent with the given tools","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:write"]}],"parameters":[{"name":"agent_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"system_prompt":{"description":"How the agent should behave","title":"System Prompt","type":"string"},"description":{"description":"What the agent does, shown to people choosing an agent","title":"Description","type":"string"},"tools":{"description":"Integration tools the agent may call, e.g. [{\"integration\": \"github\", \"tools\": [\"github_issues_get\"]}]","items":{"$ref":"#/components/schemas/ConfigureLlmIntegrationToolsInput"},"title":"Tools","type":"array"},"guild_tools":{"description":"Built-in Guild tools the agent may call, e.g. [\"guild_search_agent\"]","items":{"type":"string"},"title":"Guild Tools","type":"array"},"mode":{"default":"one-shot","description":"One-shot answers once; multi-turn keeps a conversation (default one-shot)","enum":["one-shot","multi-turn"],"title":"Mode","type":"string"},"summary":{"default":null,"description":"What changed","title":"Summary","type":["string","null"]},"version_number":{"default":"1.0.0","title":"Version Number","type":"string"}},"required":["system_prompt","description","tools"],"title":"ConfigureAgentLlmInput","type":"object"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionWithJob"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/agents/{agent_id_or_name}/versions":{"get":{"operationId":"list_agent_versions","summary":"List an agent's versions","tags":["agents"],"parameters":[{"name":"agent_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"type","in":"query","required":false,"schema":{"default":null,"enum":["EPHEMERAL","COMMITTED",null],"title":"AgentVersionType","type":["string","null"]}},{"name":"statuses","in":"query","required":false,"schema":{"default":null,"title":"Statuses","type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AgentVersion"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{},{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}]},"post":{"operationId":"create_agent_version","summary":"Create an agent version","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:write"]}],"parameters":[{"name":"agent_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"version_type":{"$ref":"#/components/schemas/AgentVersionType"},"skip_validation":{"default":false,"title":"Skip Validation","type":"boolean"},"publish":{"default":false,"description":"Publish the version once it passes validation","title":"Publish","type":"boolean"},"files":{"default":null,"description":"Every source file of the new version, as path and content","title":"Files","items":{"$ref":"#/components/schemas/AgentVersionFile"},"type":["array","null"]},"bundle":{"default":null,"title":"Bundle","type":["string","null"]},"encoding":{"default":null,"title":"Encoding","type":["string","null"]},"commit_sha":{"default":null,"title":"Commit Sha","type":["string","null"]},"summary":{"default":null,"description":"What changed","title":"Summary","type":["string","null"]},"version_number":{"default":null,"title":"Version Number","type":["string","null"]}},"required":["version_type"],"title":"CreateAgentVersionInput","type":"object"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionWithJob"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionWithJob"}}},"links":{"ValidationJob":{"operationId":"get_validation_job","parameters":{"version_id":"$response.body#/id"},"description":"When the response has a job_id, poll the new version's validation until its status is final. Skipping validation creates no job."}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/agents/{agent_id_or_name}/versions/{version_id}/revalidate":{"post":{"operationId":"post_revalidate_version","summary":"Revalidate a version","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:write"]}],"parameters":[{"name":"agent_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionWithJob"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/agents/{agent_id_or_name}/wait":{"get":{"operationId":"gen_wait_for_agent","summary":"Wait for an agent's initialization to reach READY","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}],"parameters":[{"name":"agent_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"name":"timeout_seconds","in":"query","required":false,"schema":{"default":null,"description":"Optional observation deadline in seconds; without native MCP Tasks it is capped by the server's configured window. Expiry returns wait_complete=false without stopping initialization","title":"Timeout Seconds","exclusiveMinimum":true,"type":["number","null"],"minimum":0}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentWait"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/customer_connectors/enroll":{"post":{"operationId":"enroll_connector","summary":"Enroll a customer connector and issue its credentials","tags":["other"],"security":[{"connectorToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"request_id":{"format":"uuid","title":"Request Id","type":"string"}},"required":["request_id"],"title":"EnrollmentInput","type":"object"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialResult"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}},"x-guild-response-model":"CredentialResult"},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/customer_connectors/renew":{"post":{"operationId":"renew_connector","summary":"Renew an enrolled customer connector's credentials","tags":["other"],"security":[{"connectorToken":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialResult"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}},"x-guild-response-model":"CredentialResult"},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/integrations/{integration_id_or_name}/tools":{"get":{"operationId":"list_integration_tools","summary":"List the tools an integration provides","tags":["integrations"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["integrations:read"]}],"parameters":[{"name":"integration_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/integrations/{integration_id_or_name}/tools/{tool_name}":{"get":{"operationId":"get_integration_tool","summary":"Read one published tool's input and output contracts","tags":["integrations"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["integrations:read"]}],"parameters":[{"name":"integration_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"name":"tool_name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/me":{"get":{"operationId":"get_public_me","summary":"Get the identity of the calling credential","description":"An API key gets its own record, including the name of the account that owns it. An OAuth token gets the user it acts as, the client that holds it, and the scopes it was granted.","tags":["other"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMe"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}},"x-guild-response-model":"PublicMe"},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/me/email-invitations":{"get":{"operationId":"get_my_email_invitations","summary":"List organization invitations sent to the current user's email","description":"These are organization invitations sent to the user's email address, which can be accepted at sign-up. Returns pending invitations unless ``status`` asks for another status.","tags":["accounts"],"security":[{"oauth2":["organizations:read"]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"default":null,"title":"Status","type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationOrganization"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/me/invitations":{"get":{"operationId":"list_my_invitations","summary":"List organization invitations sent to the current user","tags":["accounts"],"security":[{"oauth2":["organizations:read"]}],"parameters":[{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"status","in":"query","required":false,"schema":{"default":null,"title":"Status","type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/InvitationOrganization"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/me/organizations":{"get":{"operationId":"list_organizations","summary":"List the current user's organization memberships","tags":["accounts"],"security":[{"oauth2":["organizations:read"]}],"parameters":[{"$ref":"#/components/parameters/SortBy"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"search","in":"query","required":false,"schema":{"default":null,"title":"Search","type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/OrganizationMembership"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/me/workspaces":{"get":{"operationId":"get_my_workspaces","summary":"List the current user's workspaces","tags":["workspaces"],"security":[{"oauth2":["workspaces:read"]}],"parameters":[{"$ref":"#/components/parameters/SortBy"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"owner","in":"query","required":false,"schema":{"default":null,"title":"Owner","format":"uuid","type":["string","null"]}},{"name":"filter","in":"query","required":false,"schema":{"default":null,"description":"'my' for the user's own workspaces (default), 'all' to add their organizations'","title":"Filter","enum":["my","all",null],"type":["string","null"]}},{"name":"for_agent","in":"query","required":false,"schema":{"default":null,"title":"For Agent","type":["string","null"]}},{"name":"archived","in":"query","required":false,"schema":{"default":null,"title":"Archived","type":["boolean","null"]}},{"name":"search","in":"query","required":false,"schema":{"default":null,"title":"Search","type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Workspace"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/oauth/authorize":{"get":{"operationId":"oauth_authorize_entry","summary":"Start an OAuth authorization by redirecting to the consent page","tags":["other"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/oauth/register":{"post":{"operationId":"oauth_register","summary":"Register an OAuth client","tags":["other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"description":"The RFC 7591 fields this server honors; any others a client sends are\nignored, as the RFC allows.","properties":{"client_name":{"maxLength":128,"minLength":1,"title":"Client Name","type":"string"},"redirect_uris":{"items":{"type":"string"},"maxItems":5,"minItems":1,"title":"Redirect Uris","type":"array"},"token_endpoint_auth_method":{"default":"none","title":"Token Endpoint Auth Method","type":"string","enum":["none"]},"grant_types":{"default":["authorization_code","refresh_token"],"items":{"enum":["authorization_code","refresh_token"],"type":"string"},"title":"Grant Types","type":"array"},"response_types":{"default":["code"],"items":{"type":"string","enum":["code"]},"title":"Response Types","type":"array"}},"required":["client_name","redirect_uris"],"title":"RegisterClientInput","type":"object"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/oauth/token":{"post":{"operationId":"oauth_token","summary":"Exchange an authorization code or refresh token for an access token","tags":["other"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/organizations/{org_id_or_name}":{"get":{"operationId":"get_organization","summary":"Get an organization","tags":["accounts"],"security":[{"oauth2":["organizations:read"]}],"parameters":[{"name":"org_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/organizations/{org_id_or_name}/invitations":{"get":{"operationId":"get_organization_invitations","summary":"List an organization's invitations","tags":["accounts"],"security":[{"oauth2":["organizations:read"]}],"parameters":[{"name":"org_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"status","in":"query","required":false,"schema":{"default":null,"title":"Status","type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/InvitationOrganization"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/organizations/{org_id_or_name}/members":{"get":{"operationId":"get_organization_members","summary":"List an organization's members as users","tags":["accounts"],"security":[{"oauth2":["organizations:read"]}],"parameters":[{"name":"org_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SortBy"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"search","in":"query","required":false,"schema":{"default":null,"title":"Search","type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/OrganizationMembership"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/organizations/{org_id_or_name}/memberships":{"get":{"operationId":"get_organization_memberships","summary":"List an organization's memberships","tags":["accounts"],"security":[{"oauth2":["organizations:read"]}],"parameters":[{"name":"org_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SortBy"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"search","in":"query","required":false,"schema":{"default":null,"description":"Filter members by name","title":"Search","type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/OrganizationMembership"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/organizations/{org_id_or_name}/usage":{"get":{"operationId":"get_organization_usage","summary":"Get usage statistics for an organization","description":"The stats include costs, so a user must be an admin of the organization. An account API key holding ``usage:read`` reads its own account, as the ``/accounts/<account>/usage/*`` routes admit it, and any other organization is a 404 to it; the workspaces it cannot read, the members-only ones, are left out of every figure (``gen_usage_stats``).","tags":["accounts"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["usage:read"]}],"parameters":[{"name":"org_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"default":"24h","enum":["6h","24h","7d"],"title":"Range","type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/sessions/{session_id}":{"get":{"operationId":"gen_session","summary":"Get a session","tags":["sessions"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["sessions:read"]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Session"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/sessions/{session_id}/events":{"get":{"operationId":"gen_session_events","summary":"List session events","tags":["sessions"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["sessions:read"]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"$ref":"#/components/parameters/SortBy"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"from_id","in":"query","required":false,"schema":{"default":null,"description":"Only events after this event ID, e.g. the message you sent","title":"From Id","type":["string","null"]}},{"name":"types","in":"query","required":false,"schema":{"default":null,"description":"Event types to return, comma-separated in a query string, e.g. user_message,agent_notification_message","title":"Types","items":{"$ref":"#/components/schemas/EventType"},"type":["array","null"]},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Event"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"create_session_event","summary":"Send a message to a session","tags":["sessions"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["sessions:write"]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CreateTextSessionEventInput"},{"$ref":"#/components/schemas/CreateJsonSessionEventInput"},{"$ref":"#/components/schemas/CreateMultimodalSessionEventInput"},{"$ref":"#/components/schemas/CreateMultipartSessionEventInput"}]}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Event"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/sessions/{session_id}/runtimes":{"get":{"operationId":"get_session_runtimes","summary":"List the runtimes a session's tasks ran on","tags":["sessions"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["sessions:read"]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"$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/RuntimeContainer"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/sessions/{session_id}/tasks":{"get":{"operationId":"gen_session_tasks","summary":"List session tasks","tags":["sessions"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["sessions:read"]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"$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/Task"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/sessions/{session_id}/wait":{"get":{"operationId":"gen_wait_for_session","summary":"Observe the root task after a send-time session event watermark","tags":["sessions"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["sessions:read"]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"user_event_id","in":"query","required":true,"schema":{"description":"The user message event ID returned by the send call","title":"User Event Id","type":"string"}},{"name":"after_event_id","in":"query","required":true,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"string","enum":["start"]}],"description":"Forward the wait_after_event_id returned by the send call unchanged; start denotes an empty snapshot","title":"After Event Id"}},{"name":"timeout_seconds","in":"query","required":false,"schema":{"default":null,"description":"Optional observation deadline in seconds; without native MCP Tasks it is capped by the server's configured window. Expiry returns wait_complete=false without stopping the session","title":"Timeout Seconds","exclusiveMinimum":true,"type":["number","null"],"minimum":0}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitForSessionResponse"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}},"x-guild-response-model":"WaitForSessionResponse"},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/skills/{skill_id_or_name}":{"get":{"operationId":"get_skill","summary":"Get a skill","tags":["skills"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["skills:read"]}],"parameters":[{"name":"skill_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillDetail"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}},"x-guild-response-model":"SkillDetail"},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/skills/{skill_id_or_name}/versions":{"post":{"operationId":"create_skill_version","summary":"Create a skill version","tags":["skills"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["skills:write"]}],"parameters":[{"name":"skill_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"version_number":{"description":"Semantic version, higher than the latest, e.g. 1.0.1","title":"Version Number","type":"string"},"description":{"description":"What changed","title":"Description","type":"string"},"body":{"description":"The skill's content, in Markdown","maxLength":262144,"title":"Body","type":"string"}},"required":["version_number","description","body"],"title":"CreateSkillVersionInput","type":"object"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillVersion"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/triggers/{trigger_id}":{"delete":{"operationId":"delete_trigger","summary":"Delete a trigger","tags":["triggers"],"security":[{"oauth2":["workspaces:write"]}],"parameters":[{"name":"trigger_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No content","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"get":{"operationId":"get_trigger","summary":"Get a trigger","tags":["triggers"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:read"]}],"parameters":[{"name":"trigger_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceTrigger"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"patch":{"operationId":"update_trigger","summary":"Update a trigger","tags":["triggers"],"security":[{"oauth2":["workspaces:write"]}],"parameters":[{"name":"trigger_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"description":"Fields patchable on any trigger type.","properties":{"name":{"default":null,"description":"Trigger name","title":"Name","type":["string","null"]},"event_type":{"default":null,"title":"Event Type","type":["string","null"]},"action":{"default":null,"title":"Action","type":["string","null"]},"service_config":{"default":null,"title":"Service Config","additionalProperties":true,"type":["object","null"]},"frequency":{"default":null,"description":"How often to run","enum":["HOURLY","DAILY","WEEKLY","MONTHLY","CRON",null],"title":"TimeTriggerFrequency","type":["string","null"]},"time_of_day":{"default":null,"description":"HH:MM, for DAILY, WEEKLY and MONTHLY","title":"Time Of Day","type":["string","null"]},"days_of_month":{"default":null,"title":"Days Of Month","type":["string","null"]},"days_of_week":{"default":null,"description":"Comma-separated day names, e.g. MONDAY,THURSDAY, for WEEKLY","title":"Days Of Week","type":["string","null"]},"minutes_of_hour":{"default":null,"title":"Minutes Of Hour","type":["string","null"]},"cron_expression":{"default":null,"description":"Cron expression, for CRON","title":"Cron Expression","type":["string","null"]},"cron_timezone":{"default":null,"title":"Cron Timezone","type":["string","null"]},"agent_input":{"default":null,"description":"What the agent receives each run, e.g. {\"type\": \"text\", \"text\": \"...\"}","title":"Agent Input","additionalProperties":true,"type":["object","null"]}},"title":"UpdateTriggerBody","type":"object"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceTrigger"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/triggers/{trigger_id}/activate":{"post":{"operationId":"activate_trigger","summary":"Activate a trigger","tags":["triggers"],"security":[{"oauth2":["workspaces:write"]}],"parameters":[{"name":"trigger_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceTrigger"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/triggers/{trigger_id}/deactivate":{"post":{"operationId":"deactivate_trigger","summary":"Deactivate a trigger","tags":["triggers"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:write"]}],"parameters":[{"name":"trigger_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceTrigger"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/triggers/{trigger_id}/run":{"post":{"operationId":"run_trigger","summary":"Run a scheduled trigger now","tags":["triggers"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:write"]}],"parameters":[{"name":"trigger_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceTrigger"}}},"links":{"TriggerSessions":{"operationId":"get_trigger_sessions","parameters":{"trigger_id":"$request.path.trigger_id"},"description":"The run starts a session in the background; it appears among the trigger's sessions."}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/triggers/{trigger_id}/sessions":{"get":{"operationId":"get_trigger_sessions","summary":"List the sessions a trigger started","tags":["triggers"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["sessions:read"]}],"parameters":[{"name":"trigger_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"$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/Session"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/users/{user_id_or_name}":{"get":{"operationId":"get_user","summary":"Get a user by id or handle","tags":["accounts"],"security":[{"oauth2":["organizations:read"]}],"parameters":[{"name":"user_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserProfile"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}},"x-guild-response-model":"UserProfile"},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/users/{user_id_or_name}/organizations":{"get":{"operationId":"get_user_organizations","summary":"List a user's organization memberships, by id or handle","tags":["accounts"],"security":[{"oauth2":["organizations:read"]}],"parameters":[{"name":"user_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SortBy"},{"$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/OrganizationMembership"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}":{"get":{"operationId":"get_agent_version","summary":"Get an agent version","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersion"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}/code":{"get":{"operationId":"get_version_code","summary":"Get an agent version's source files","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}/jobs":{"get":{"operationId":"list_jobs","summary":"List all jobs for an agent version","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Job"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}/jobs/{job_id}/wait":{"get":{"operationId":"gen_wait_for_job","summary":"Wait for one validation or publish job and return its durable status","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"timeout_seconds","in":"query","required":false,"schema":{"default":null,"description":"Optional observation deadline in seconds; without native MCP Tasks it is capped by the server's configured window. Expiry returns wait_complete=false without stopping the job","title":"Timeout Seconds","exclusiveMinimum":true,"type":["number","null"],"minimum":0}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobWait"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}/publish":{"post":{"operationId":"publish_agent_version","summary":"Publish an agent version","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:write"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"properties":{"force_publish":{"default":false,"title":"Force Publish","type":"boolean"}},"title":"PublishAgentVersionInput","type":"object"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionWithJob"}}},"links":{"PublishJob":{"operationId":"get_publish_job","parameters":{"version_id":"$request.path.version_id"},"description":"Poll the publish job until its status is final."}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}/publish/job":{"get":{"operationId":"get_publish_job","summary":"Get latest publish job for an agent version","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Job"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}/publish/steps":{"get":{"operationId":"list_publish_steps","summary":"List publish steps for an agent version","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobStep"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}/publish_pre_checks":{"post":{"operationId":"create_publish_pre_checks","summary":"Run the checks a version must pass before publishing","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:write"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobStep"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}/tool-access":{"get":{"operationId":"get_agent_version_tool_access","summary":"Classify each of a version's tools as read or write","description":"Integration tools resolve to \"read\" or \"write\" from their underlying operation's HTTP method (or MCP hint); built-in and custom tools are reported as \"unknown\".","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}/tools":{"get":{"operationId":"get_agent_version_tools","summary":"List a version's resolved tools: integration, sub-agent or service","description":"Empty for versions built before tools were resolved.","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"$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/AgentVersionTool"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}/unpublish":{"post":{"operationId":"unpublish_agent_version","summary":"Unpublish an agent version","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:write"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersion"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}/validation/job":{"get":{"operationId":"get_validation_job","summary":"Get latest validation job for an agent version","description":"Returns either VALIDATION or PUBLISH jobs (publish jobs include validation).","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Job"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/versions/{version_id}/validation/steps":{"get":{"operationId":"list_validation_steps","summary":"List validation steps for an agent version","description":"Returns steps from either VALIDATION or PUBLISH jobs.","tags":["agents"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["agents:read"]}],"parameters":[{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobStep"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspace_agents/{workspace_agent_id}":{"delete":{"operationId":"delete_workspace_agent","summary":"Uninstall an agent from a workspace","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:write"]}],"parameters":[{"name":"workspace_agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"get":{"operationId":"get_workspace_agent","summary":"Get an installed agent","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:read"]}],"parameters":[{"name":"workspace_agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceAgent"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"patch":{"operationId":"update_workspace_agent","summary":"Update an installed agent's version or settings","tags":["workspaces"],"security":[{"oauth2":["workspaces:write"]}],"parameters":[{"name":"workspace_agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"properties":{"should_autoupdate":{"default":null,"description":"Move to each new published version automatically","title":"Should Autoupdate","type":["boolean","null"]},"is_default_chat_agent":{"default":null,"title":"Is Default Chat Agent","type":["boolean","null"]},"new_version_id":{"default":null,"description":"Agent version to run, one of the agent's published versions","title":"New Version Id","format":"uuid","type":["string","null"]},"required_credentials_mode":{"default":null,"description":"Whose credentials an agent may run with.\n\n``SHARED`` admits only org-side credentials; ``MEMBER`` admits only the\nacting member's own, plus a credential dedicated to the agent, which is\nscoped to the agent under either mode. Unset means no requirement, and the\nresolution ladder decides on its own.","enum":["SHARED","MEMBER",null],"title":"RequiredCredentialsMode","type":["string","null"]}},"title":"UpdateWorkspaceAgentInput","type":"object"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceAgent"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspace_agents/{workspace_agent_id}/credential-associations":{"get":{"operationId":"list_workspace_agent_credential_associations","summary":"List the credentials granted to an installed agent","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:read"]}],"parameters":[{"name":"workspace_agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"$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/CredentialAssociation"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"create_workspace_agent_credential_association","summary":"Grant a credential to an installed agent","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["integrations:write"]}],"parameters":[{"name":"workspace_agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"auth_config_id":{"format":"uuid","title":"Auth Config Id","type":"string"},"credentials_id":{"format":"uuid","title":"Credentials Id","type":"string"},"replace":{"default":false,"description":"Revoke the bindings that would block this one, in the same transaction: either everything commits or nothing changes. A dedicated key and a grant serving every member exclude each other.","title":"Replace","type":"boolean"}},"required":["auth_config_id","credentials_id"],"title":"CreateCredentialAssociationInput","type":"object"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialAssociation"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspace_agents/{workspace_agent_id}/credential-associations/{association_id}":{"delete":{"operationId":"delete_workspace_agent_credential_association","summary":"Revoke a credential from an installed agent","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["integrations:write"]}],"parameters":[{"name":"workspace_agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"association_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialAssociation"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspace_agents/{workspace_agent_id}/credentials/api-key":{"post":{"operationId":"connect_workspace_agent_api_key","summary":"Create a dedicated API-key credential for a workspace agent","description":"The key is stored under the workspace owner's account and used only by this agent. Callable by a user or by an account API key with integrations write scope; a key can only connect credentials to agents it installed itself, under its own account.\n\nWith ``replace``, every live grant on the agent for the integration that serves every member is revoked in the same transaction, whoever made it. A member's grant of their own credential serves only them, so it stays.","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["integrations:write"]}],"parameters":[{"name":"workspace_agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"owner_id","in":"query","required":true,"schema":{"title":"Owner Id","type":"string"}},{"name":"auth_config_id","in":"query","required":true,"schema":{"format":"uuid","title":"Auth Config Id","type":"string"}},{"name":"event_id","in":"query","required":false,"schema":{"default":null,"title":"Event Id","type":["string","null"]}},{"name":"replace","in":"query","required":false,"schema":{"default":false,"description":"Revoke the bindings that would block this one, in the same transaction: either everything commits or nothing changes. A dedicated key and a grant serving every member exclude each other.","title":"Replace","type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialAssociation"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspace_agents/{workspace_agent_id}/upgrades":{"get":{"operationId":"get_workspace_agent_upgrades","summary":"List an installed agent's version upgrades","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:read"]}],"parameters":[{"name":"workspace_agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"$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/WorkspaceAgentUpgrade"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspaces":{"post":{"operationId":"create_workspace","summary":"Create a workspace","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Workspace name","title":"Name","type":"string"},"owner_id":{"description":"Owning user or organization, by name or ID","title":"Owner Id","type":"string"}},"required":["name","owner_id"],"title":"CreateWorkspaceInput","type":"object"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Workspace"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspaces/{workspace_id_or_name}":{"get":{"operationId":"get_workspace","summary":"Get a workspace and its compiled context","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:read"]}],"parameters":[{"name":"workspace_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Workspace"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspaces/{workspace_id_or_name}/contexts":{"get":{"operationId":"get_workspace_contexts","summary":"List a workspace's contexts","tags":["workspaces"],"security":[{"oauth2":["workspaces:read"]}],"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"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"create_workspace_context","summary":"Create a workspace context","tags":["workspaces"],"security":[{"oauth2":["workspaces:write"]}],"parameters":[{"name":"workspace_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"status":{"$ref":"#/components/schemas/ContextStatus","description":"PUBLISHED to use it now, DRAFT to save it for review"},"context":{"description":"The instructions, in Markdown","title":"Context","type":"string"},"summary":{"default":null,"description":"What changed","title":"Summary","type":["string","null"]}},"required":["status","context"],"title":"CreateWorkspaceContextInput","type":"object"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Context"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspaces/{workspace_id_or_name}/memberships":{"get":{"operationId":"get_workspace_memberships","summary":"List a workspace's members","tags":["workspaces"],"security":[{"oauth2":["workspaces:read"]}],"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/WorkspaceMembership"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspaces/{workspace_id_or_name}/sessions":{"get":{"operationId":"get_workspace_sessions","summary":"List a workspace's sessions","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["sessions:read"]}],"parameters":[{"name":"workspace_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"trigger_id","in":"query","required":false,"schema":{"default":null,"title":"Trigger Id","format":"uuid","type":["string","null"]}},{"name":"types","in":"query","required":false,"schema":{"default":null,"title":"Types","type":["string","null"]}},{"name":"origin","in":"query","required":false,"schema":{"default":null,"description":"Which Smith surface started the chat; unset outside Smith workspaces.","enum":["CHAT","INSIGHTS",null],"title":"SmithSessionOrigin","type":["string","null"]}},{"name":"workspace_agent_id","in":"query","required":false,"schema":{"default":null,"title":"Workspace Agent Id","format":"uuid","type":["string","null"]}},{"name":"include_archived","in":"query","required":false,"schema":{"default":false,"title":"Include Archived","type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Session"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"create_workspace_session","summary":"Create a session in a workspace","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["sessions:write"]}],"parameters":[{"name":"workspace_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","description":"Fields inferred from source; types not verified.","properties":{"session_type":{}}}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"links":{"Session":{"operationId":"gen_session","parameters":{"session_id":"$response.body#/id"},"description":"Read the session; its root task's status shows progress."},"SessionEvents":{"operationId":"gen_session_events","parameters":{"session_id":"$response.body#/id"},"description":"Read the session's events as they arrive."}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspaces/{workspace_id_or_name}/triggers":{"get":{"operationId":"get_triggers","summary":"List a workspace's triggers","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:read"]}],"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/WorkspaceTrigger"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"create_trigger","summary":"Create a trigger in a workspace","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:write"]}],"parameters":[{"name":"workspace_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"discriminator":{"mapping":{"api":"#/components/schemas/CreateApiTriggerBody","time":"#/components/schemas/CreateTimeTriggerBody","webhook":"#/components/schemas/CreateWebhookTriggerBody"},"propertyName":"type"},"oneOf":[{"$ref":"#/components/schemas/CreateWebhookTriggerBody"},{"$ref":"#/components/schemas/CreateTimeTriggerBody"},{"$ref":"#/components/schemas/CreateApiTriggerBody"}]}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspaces/{workspace_id_or_name}/workspace_agents":{"get":{"operationId":"get_workspace_agents","summary":"List the agents installed in a workspace","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:read"]}],"parameters":[{"name":"workspace_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SortBy"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"search","in":"query","required":false,"schema":{"default":null,"title":"Search","type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/WorkspaceAgent"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"add_workspace_agent","summary":"Install an agent in a workspace","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:write"]}],"parameters":[{"name":"workspace_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"agent_id":{"description":"Agent ID","format":"uuid","title":"Agent Id","type":"string"},"should_autoupdate":{"default":true,"title":"Should Autoupdate","type":"boolean"},"is_default_chat_agent":{"default":false,"title":"Is Default Chat Agent","type":"boolean"},"event_id":{"default":null,"title":"Event Id","format":"uuid","type":["string","null"]}},"required":["agent_id"],"title":"AddWorkspaceAgentInput","type":"object"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceAgent"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspaces/{workspace_id_or_name}/workspace_skills":{"get":{"operationId":"get_workspace_skills","summary":"List the skills attached to a workspace","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:read","skills:read"]}],"parameters":[{"name":"workspace_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SortBy"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"search","in":"query","required":false,"schema":{"default":null,"title":"Search","type":["string","null"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/WorkspaceSkill"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"add_workspace_skill","summary":"Attach a skill to a workspace","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:write","skills:read"]}],"parameters":[{"name":"workspace_id_or_name","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"skill_id":{"format":"uuid","title":"Skill Id","type":"string"}},"required":["skill_id"],"title":"AddWorkspaceSkillInput","type":"object"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceSkill"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]},"/workspaces/{workspace_id_or_name}/workspace_skills/{workspace_skill_id}":{"delete":{"operationId":"delete_workspace_skill","summary":"Detach a skill from a workspace","tags":["workspaces"],"security":[{"apiKey":[]},{"bearerApiKey":[]},{"oauth2":["workspaces:write","skills:read"]}],"parameters":[{"name":"workspace_id_or_name","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"servers":[{"url":"https://api.guild.ai/v1","description":"Production"}]}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, machine-readable error identifier."},"message":{"type":"string","description":"Human-readable description of the failure."},"resolution":{"type":"string","description":"What to do next, if there is a clear fix."}}}}},"JsonRpcError":{"type":"object","required":["jsonrpc","error"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"type":"null"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","description":"JSON-RPC error code."},"message":{"type":"string"},"data":{"description":"Optional detail about the failure."}}}}},"JsonRpcRequest":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","description":"MCP JSON-RPC method, e.g. 'initialize', 'tools/list', or 'tools/call'. See https://www.guild.ai/.well-known/mcp/server-card.json for the full typed tool catalog (search_blog, search_pages, get_company_info, compare_guild, request_demo, open_demo_request_form)."},"params":{"type":"object"}}},"JsonRpcResponse":{"type":"object","required":["jsonrpc"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"result":{"type":"object"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"MarkdownErrorDocument":{"type":"string","description":"Markdown document describing the failure, e.g. `# Not found`."},"Post":{"type":"object","required":["title","url","markdown_url"],"properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri","description":"The post page."},"markdown_url":{"type":"string","format":"uri","description":"The same post as `text/markdown` (its `.md` twin)."},"category":{"type":["string","null"]},"published":{"type":["string","null"],"format":"date","description":"Publication date."},"excerpt":{"type":["string","null"]}}},"PostList":{"type":"object","required":["items","next_cursor"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"}},"next_cursor":{"type":["string","null"],"description":"Opaque cursor for the next page: pass it back unchanged as `cursor`. `null` on the last page."}}},"Account":{"oneOf":[{"$ref":"#/components/schemas/Organization"},{"$ref":"#/components/schemas/User"}]},"AccountItem":{"description":"An account as ``gen_serialize_account`` emits it. Users and\norganizations share the account pattern; ``email_domain`` appears only\nfor organizations.","properties":{"id":{"format":"uuid","title":"Id","type":"string"},"entity_type":{"title":"Entity Type","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"type":{"enum":["user","organization"],"title":"Type","type":"string"},"name":{"title":"Name","type":"string"},"full_name":{"title":"Full Name","type":["string","null"]},"avatar_url":{"title":"Avatar Url","type":["string","null"]},"bio":{"title":"Bio","type":["string","null"]},"banner_url":{"title":"Banner Url","type":["string","null"]},"website_url":{"title":"Website Url","type":["string","null"]},"github_url":{"title":"Github Url","type":["string","null"]},"x_url":{"title":"X Url","type":["string","null"]},"linkedin_url":{"title":"Linkedin Url","type":["string","null"]},"discord_url":{"title":"Discord Url","type":["string","null"]},"youtube_url":{"title":"Youtube Url","type":["string","null"]},"threads_url":{"title":"Threads Url","type":["string","null"]},"cached_likes_public_count":{"title":"Cached Likes Public Count","type":"integer"},"cached_forks_public_count":{"title":"Cached Forks Public Count","type":"integer"},"cached_installs_public_count":{"title":"Cached Installs Public Count","type":"integer"},"email_domain":{"default":null,"title":"Email Domain","type":["string","null"]}},"required":["id","entity_type","created_at","updated_at","type","name","full_name","avatar_url","bio","banner_url","website_url","github_url","x_url","linkedin_url","discord_url","youtube_url","threads_url","cached_likes_public_count","cached_forks_public_count","cached_installs_public_count"],"title":"AccountItem","type":"object"},"Agent":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"agent_type":{"type":"string","enum":["GUILD_TYPESCRIPT","GUILD_NATIVE","GOOSE","OPENCLAW","LANGGRAPH","ADK"]},"description":{"type":"string","maxLength":8192,"description":"Manual description field. Can be empty; the effective description falls back to generated_description."},"is_public":{"type":"boolean","description":"Whether the asset is visible to the community or only its owner."},"name":{"type":"string","maxLength":100,"description":"Unique name identifying the asset within the owner account."},"owner_id":{"type":"string","format":"uuid","description":"The account that owns this entity."},"cached_forks_count":{"type":"integer","description":"A cached version of the forks count. Might not be up to date."},"cached_installs_count":{"type":"integer","description":"A cached version of the installs count. Might not be up to date."},"cached_likes_count":{"type":"integer","description":"A cached version of the likes count. Might not be up to date."},"is_pinned":{"type":"boolean","description":"If true, it means the agent is pinned on the owner's account's profile."},"moderation_state":{"type":"string","enum":["ACTIVE","DEMOTED","UNLISTED","DISABLED","TAKEN_DOWN"],"description":"Operator-controlled moderation/curation state. Owners cannot change this; only operators can, via the hub kebab menu or ops tooling."},"status":{"type":"string","enum":["CREATED","GIT_REPOSITORY_CREATED","READY"]},"archived_at":{"type":["string","null"],"format":"date-time"},"archived_by_id":{"type":["string","null"],"format":"uuid"},"avatar_url":{"type":["string","null"],"maxLength":255},"category_id":{"type":["string","null"],"format":"uuid","description":"The category this agent is sorted in."},"creation_template":{"type":["string","null"],"enum":["LLM","AUTO_MANAGED_STATE","BLANK","GOOSE","GUILD_NATIVE","OPENCLAW","LANGGRAPH","ADK",null],"description":"If applicable, the template that was selected during the creation of this agent. Note: it doesn't mean the agent is still following the template now."},"creator_id":{"type":["string","null"],"format":"uuid","description":"The user, agent or API key that created this agent. Null for legacy rows created before creator attribution was recorded."},"forked_from_id":{"type":["string","null"],"format":"uuid","description":"If applicable, the ID of the agent version this agent was forked from."},"generated_description":{"type":["string","null"],"maxLength":8192,"description":"LLM-generated description based on agent code. Regenerated automatically on every commit."},"maintainer_id":{"type":["string","null"],"format":"uuid","description":"OPTIONAL. Refers to the person within an organization that is tasked with maintaining the agent."},"archived_by":{},"category":{},"creator":{},"forks_count":{"type":"integer","description":"Number of times this agent has been forked"},"full_name":{"type":"string","description":"Full agent name in format \"owner_name/agent_name\""},"git_url":{"type":"string","description":"URL to the agent's git repository"},"installs_count":{"type":"integer","description":"Number of times this agent has been installed in workspaces"},"is_description_autogenerated":{},"last_updated_by":{},"latest_published_version":{},"latest_version":{},"likes_count":{"type":"integer","description":"Number of likes this agent has received"},"maintainer":{"type":["object","null"],"description":"Maintainer of the agent (for organization-owned agents)"},"owner":{"$ref":"#/components/schemas/Account"},"public_profile_url":{},"type":{},"viewer_can_edit":{"type":"boolean","description":"Whether the current viewer can edit this agent"}}},"AgentVersion":{"oneOf":[{"$ref":"#/components/schemas/AgentVersionCommitted"},{"$ref":"#/components/schemas/AgentVersionEphemeral"}]},"AgentVersionCommitted":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"agent_id":{"type":"string","format":"uuid"},"author_id":{"type":"string","format":"uuid"},"validation_status":{"type":"string","enum":["SKIPPED","PENDING","RUNNING","PASSED","FAILED"]},"dependencies":{"type":["object","null"],"description":"npm package.json dependencies"},"description":{"type":["string","null"],"maxLength":8192,"description":"Description for the agent extracted from the agent code."},"env_references":{"type":["array","null"],"items":{},"description":"Workspace variable keys referenced as {{env.KEY}} in the version's prompt, extracted at build time"},"input_schema":{"type":["object","null"],"description":"JSON Schema from Zod input"},"llm_models":{"type":["array","null"],"items":{},"description":"Acceptable provider/model pairs from guild.yaml `models`, tried in order. An entry naming a model asks for exactly it; an entry naming only a provider lets the server pick. NULL means the agent declared none and runs on the session default. E.g. [{\"provider\": \"ANTHROPIC\", \"model\": \"claude-sonnet-5\"}, {\"provider\": \"OPENAI\"}]"},"output_schema":{"type":["object","null"],"description":"JSON Schema from Zod output"},"published_at":{"type":["string","null"],"format":"date-time"},"publishing_started_at":{"type":["string","null"],"format":"date-time"},"raw_tools":{"type":["array","null"],"items":{},"description":"Structured per-tool metadata. Each entry is a tool object discriminated by toolType (integration, legacy, agent, builtin)."},"runtime_environment_id":{"type":["string","null"],"format":"uuid"},"sha":{"type":["string","null"],"maxLength":40,"description":"Git commit SHA (40-character hexadecimal). For agents: set on version creation. For integrations: set after code is stored in GitHub."},"summary":{"type":["string","null"],"maxLength":500,"description":"Commit message summary. For agents: set on version creation. For integrations: set after code is stored in GitHub."},"tools":{"type":["array","null"],"items":{}},"version_number":{"type":["string","null"],"maxLength":100,"description":"The semantic version number (i.e., MAJOR.MINOR.PATCH) of this version"},"agent":{},"author":{},"status":{},"version_type":{}}},"AgentVersionEphemeral":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"agent_id":{"type":"string","format":"uuid"},"author_id":{"type":"string","format":"uuid"},"files":{"type":"object","description":"The files for this version and their content. Format: {[key: filename]: content}"},"validation_status":{"type":"string","enum":["SKIPPED","PENDING","RUNNING","PASSED","FAILED"]},"dependencies":{"type":["object","null"],"description":"npm package.json dependencies"},"description":{"type":["string","null"],"maxLength":8192,"description":"Description for the agent extracted from the agent code."},"env_references":{"type":["array","null"],"items":{},"description":"Workspace variable keys referenced as {{env.KEY}} in the version's prompt, extracted at build time"},"input_schema":{"type":["object","null"],"description":"JSON Schema from Zod input"},"llm_models":{"type":["array","null"],"items":{},"description":"Acceptable provider/model pairs from guild.yaml `models`, tried in order. An entry naming a model asks for exactly it; an entry naming only a provider lets the server pick. NULL means the agent declared none and runs on the session default. E.g. [{\"provider\": \"ANTHROPIC\", \"model\": \"claude-sonnet-5\"}, {\"provider\": \"OPENAI\"}]"},"output_schema":{"type":["object","null"],"description":"JSON Schema from Zod output"},"raw_tools":{"type":["array","null"],"items":{},"description":"Structured per-tool metadata. Each entry is a tool object discriminated by toolType (integration, legacy, agent, builtin)."},"runtime_environment_id":{"type":["string","null"],"format":"uuid"},"tools":{"type":["array","null"],"items":{}},"version_number":{"type":["string","null"],"maxLength":100,"description":"The semantic version number (i.e., MAJOR.MINOR.PATCH) of this version"},"agent":{},"author":{},"published_at":{},"publishing_started_at":{},"sha":{},"status":{},"summary":{},"version_type":{}}},"AgentVersionFile":{"properties":{"path":{"title":"Path","type":"string"},"content":{"title":"Content","type":"string"}},"required":["path","content"],"title":"AgentVersionFile","type":"object"},"AgentVersionTool":{"oneOf":[{"$ref":"#/components/schemas/AgentVersionToolAgent"},{"$ref":"#/components/schemas/AgentVersionToolIntegration"},{"$ref":"#/components/schemas/AgentVersionToolService"}]},"AgentVersionToolAgent":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"agent_id":{"type":"string","format":"uuid","description":"The agent this tool calls."},"operations":{"type":"array","items":{},"description":"Tool names in the agent code that resolve to this unit."},"version_id":{"type":"string","format":"uuid","description":"The agent version that declares this tool."},"version_range":{"type":"string","maxLength":100,"description":"npm-style semver range the declaring code requests of the agent (e.g. ^1.2.3, ~1.2.3, 1.2.3, 1.x, *)."},"locked_version_id":{"type":["string","null"],"format":"uuid","description":"The version ``version_range`` resolved to when the declaring version was built, and the one it calls -- the lockfile package.json agents get from npm. Null where the build recorded none, which then resolves the range at run time."},"agent_owner_name":{},"agent_owner_type":{},"agent_slug":{},"type":{}}},"AgentVersionToolIntegration":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"integration_id":{"type":"string","format":"uuid","description":"The integration this tool's operations belong to."},"operations":{"type":"array","items":{},"description":"Tool names in the agent code that resolve to this unit."},"version_id":{"type":"string","format":"uuid","description":"The agent version that declares this tool."},"version_range":{"type":"string","maxLength":100,"description":"npm-style semver range the declaring code requests of the integration (e.g. ^1.2.3, ~1.2.3, 1.2.3, 1.x, *)."},"integration_archived":{},"integration_slug":{},"type":{}}},"AgentVersionToolService":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"kind":{"type":"string","enum":["BUILTIN","LEGACY","INTEGRATION"],"description":"Whether this name-only tool is a platform builtin, a legacy proxied service, or an unresolved third-party integration."},"name":{"type":"string","maxLength":255,"description":"Service name (e.g. ui, console, github, zendesk)."},"operations":{"type":"array","items":{},"description":"Tool names in the agent code that resolve to this unit."},"version_id":{"type":"string","format":"uuid","description":"The agent version that declares this tool."},"type":{}}},"AgentVersionType":{"enum":["EPHEMERAL","COMMITTED"],"title":"AgentVersionType","type":"string"},"AgentVersionWithJob":{"allOf":[{"$ref":"#/components/schemas/AgentVersion"},{"type":"object","properties":{"job_id":{"type":["string","null"],"format":"uuid","description":"The validation or publish job this request started; null when it started none."}},"required":["job_id"]}]},"AgentWait":{"allOf":[{"$ref":"#/components/schemas/Agent"},{"$ref":"#/components/schemas/WaitCompletion"}]},"ApiKey":{"description":"An account API key as every key-returning endpoint serializes it. The\none-time secret is shown only in the creation response and never appears\nin this shape.","properties":{"id":{"format":"uuid","title":"Id","type":"string"},"entity_type":{"title":"Entity Type","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"type":{"title":"Type","type":"string","enum":["account"]},"name":{"title":"Name","type":["string","null"]},"permissions":{"description":"The key's scopes; write implies read.","items":{"$ref":"#/components/schemas/ApiKeyScope"},"title":"Permissions","type":"array"},"owner":{"additionalProperties":true,"description":"The account the key acts as (user or organization, item shape).","title":"Owner","type":"object"},"created_by":{"additionalProperties":true,"description":"The user who minted the key (item shape).","title":"Created By","type":"object"}},"required":["id","entity_type","created_at","updated_at","type","name","permissions","owner","created_by"],"title":"ApiKey","type":"object"},"ApiKeyScope":{"properties":{"group":{"$ref":"#/components/schemas/ApiKeyScopeGroup"},"access":{"$ref":"#/components/schemas/ApiKeyScopeAccess"}},"required":["group","access"],"title":"ApiKeyScope","type":"object"},"ApiKeyScopeAccess":{"enum":["read","write"],"title":"ApiKeyScopeAccess","type":"string"},"ApiKeyScopeGroup":{"enum":["agents","sessions","workspaces","skills","integrations","tool_call","applications","organizations","usage","evals"],"title":"ApiKeyScopeGroup","type":"string"},"ConfigureLlmIntegrationToolsInput":{"properties":{"integration":{"title":"Integration","type":"string"},"tools":{"items":{"type":"string"},"title":"Tools","type":"array"}},"required":["integration","tools"],"title":"ConfigureLlmIntegrationToolsInput","type":"object"},"Context":{"oneOf":[{"$ref":"#/components/schemas/ContextAgentGenerated"},{"$ref":"#/components/schemas/ContextSystemGenerated"},{"$ref":"#/components/schemas/ContextUserGenerated"}]},"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\n                to an LLM to provide context on this workspace. This portion of the\n                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\n                to an LLM to provide context on this workspace. This portion of the\n                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\n                this context."},"workspace_id":{"type":"string","format":"uuid"},"published_by_id":{"type":["string","null"],"format":"uuid","description":"If this context is published, this field references the user who\n                published it, if applicable. If the context is still in draft, this\n                field is null."},"summary":{"type":["string","null"],"maxLength":255,"description":"A short summary of the changes in this context version."},"task":{},"type":{}}},"ContextStatus":{"enum":["DRAFT","PUBLISHED"],"title":"ContextStatus","type":"string"},"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\n                to an LLM to provide context on this workspace. This portion of the\n                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\n                to an LLM to provide context on this workspace. This portion of the\n                context is editable by users and agents."},"status":{"type":"string","enum":["DRAFT","PUBLISHED"]},"workspace_id":{"type":"string","format":"uuid"},"published_by_id":{"type":["string","null"],"format":"uuid","description":"If this context is published, this field references the user who\n                published it, if applicable. If the context is still in draft, this\n                field is null."},"summary":{"type":["string","null"],"maxLength":255,"description":"A short summary of the changes in this context version."},"user_id":{"type":["string","null"],"format":"uuid","description":"If applicable, the user that was involved in generating this\n                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\n                to an LLM to provide context on this workspace. This portion of the\n                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\n                to an LLM to provide context on this workspace. This portion of the\n                context is editable by users and agents."},"status":{"type":"string","enum":["DRAFT","PUBLISHED"]},"workspace_id":{"type":"string","format":"uuid"},"published_by_id":{"type":["string","null"],"format":"uuid","description":"If this context is published, this field references the user who\n                published it, if applicable. If the context is still in draft, this\n                field is null."},"summary":{"type":["string","null"],"maxLength":255,"description":"A short summary of the changes in this context version."},"author":{},"type":{}}},"CreateApiTriggerBody":{"properties":{"workspace_agent_id":{"description":"Installed agent ID","format":"uuid","title":"Workspace Agent Id","type":"string"},"name":{"default":null,"description":"Trigger name","title":"Name","type":["string","null"]},"type":{"title":"Type","type":"string","enum":["api"]}},"required":["workspace_agent_id","type"],"title":"CreateApiTriggerBody","type":"object"},"CreateJsonSessionEventInput":{"properties":{"agent_id":{"default":null,"title":"Agent Id","type":["string","null"]},"selected_skills":{"default":null,"title":"Selected Skills","items":{"type":"string"},"type":["array","null"]},"content":{"additionalProperties":true,"title":"Content","type":"object"},"mode":{"title":"Mode","type":"string","enum":["json"]}},"required":["content","mode"],"title":"CreateJsonSessionEventInput","type":"object"},"CreateMultimodalSessionEventInput":{"properties":{"agent_id":{"default":null,"title":"Agent Id","type":["string","null"]},"selected_skills":{"default":null,"title":"Selected Skills","items":{"type":"string"},"type":["array","null"]},"content":{"items":{"$ref":"#/components/schemas/_MultimodalContentPart"},"minItems":1,"title":"Content","type":"array"},"mode":{"title":"Mode","type":"string","enum":["multimodal"]}},"required":["content","mode"],"title":"CreateMultimodalSessionEventInput","type":"object"},"CreateMultipartSessionEventInput":{"properties":{"agent_id":{"default":null,"title":"Agent Id","type":["string","null"]},"selected_skills":{"default":null,"title":"Selected Skills","items":{"type":"string"},"type":["array","null"]},"content":{"additionalProperties":true,"title":"Content","type":"object"},"mode":{"title":"Mode","type":"string","enum":["multipart"]}},"required":["content","mode"],"title":"CreateMultipartSessionEventInput","type":"object"},"CreateTextSessionEventInput":{"properties":{"agent_id":{"default":null,"title":"Agent Id","type":["string","null"]},"selected_skills":{"default":null,"title":"Selected Skills","items":{"type":"string"},"type":["array","null"]},"content":{"description":"The message text","title":"Content","type":"string"},"mode":{"default":"text","title":"Mode","type":"string","enum":["text"]}},"required":["content"],"title":"CreateTextSessionEventInput","type":"object"},"CreateTimeTriggerBody":{"properties":{"workspace_agent_id":{"description":"Installed agent ID","format":"uuid","title":"Workspace Agent Id","type":"string"},"name":{"default":null,"description":"Trigger name","title":"Name","type":["string","null"]},"type":{"title":"Type","type":"string","enum":["time"]},"frequency":{"$ref":"#/components/schemas/TimeTriggerFrequency","description":"How often to run"},"agent_input":{"additionalProperties":true,"description":"What the agent receives each run, e.g. {\"type\": \"text\", \"text\": \"...\"}","title":"Agent Input","type":"object"},"time_of_day":{"default":null,"description":"HH:MM, for DAILY, WEEKLY and MONTHLY","title":"Time Of Day","type":["string","null"]},"days_of_month":{"default":null,"description":"Comma-separated days of the month, -1 is the last day, for MONTHLY","title":"Days Of Month","type":["string","null"]},"days_of_week":{"default":null,"description":"Comma-separated day names, e.g. MONDAY,THURSDAY, for WEEKLY","title":"Days Of Week","type":["string","null"]},"minutes_of_hour":{"default":null,"description":"Comma-separated minutes, e.g. 0,30, for HOURLY","title":"Minutes Of Hour","type":["string","null"]},"cron_expression":{"default":null,"description":"Cron expression, for CRON","title":"Cron Expression","type":["string","null"]},"cron_timezone":{"default":null,"description":"IANA time zone for CRON, e.g. America/Los_Angeles","title":"Cron Timezone","type":["string","null"]}},"required":["workspace_agent_id","type","frequency","agent_input"],"title":"CreateTimeTriggerBody","type":"object"},"CreateWebhookTriggerBody":{"properties":{"workspace_agent_id":{"description":"Installed agent ID","format":"uuid","title":"Workspace Agent Id","type":"string"},"name":{"default":null,"description":"Trigger name","title":"Name","type":["string","null"]},"type":{"title":"Type","type":"string","enum":["webhook"]},"webhook_config_id":{"description":"The integration's webhook_config.id, which guild_search_integrations returns","format":"uuid","title":"Webhook Config Id","type":"string"},"event_type":{"default":null,"description":"One of the webhook config's events, e.g. pull_request","title":"Event Type","type":["string","null"]},"action":{"default":null,"description":"One of that event's actions, e.g. opened; every action if unset","title":"Action","type":["string","null"]},"service_config":{"default":null,"description":"Values for the webhook config's service_config_fields, e.g. {\"repo\": \"owner/name\"}","title":"Service Config","additionalProperties":true,"type":["object","null"]},"agent_input":{"default":null,"description":"Input for each run, which may include {webhook_payload}; when unset the agent receives the event payload","title":"Agent Input","additionalProperties":true,"type":["object","null"]}},"required":["workspace_agent_id","type","webhook_config_id"],"title":"CreateWebhookTriggerBody","type":"object"},"CredentialAssociation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"auth_config_id":{"type":"string","format":"uuid","description":"Integration auth config this row applies to"},"created_by_id":{"type":"string","format":"uuid","description":"The user or API key that granted this credential to the agent."},"target_id":{"type":"string","format":"uuid","description":"Workspace agent install receiving the credential; the association is scoped to this install's workspace. Account-wide availability is plain credential ownership with no association row."},"kind":{"type":"string","enum":["CONNECTED","GRANTED"],"description":"GRANTED = existing credential shared with the agent; CONNECTED = credential created for the agent (connect flow)."},"credentials_id":{"type":["string","null"],"format":"uuid","description":"Linked credential row; null while OAuth connect is pending."},"integration":{},"member_owned":{},"owner":{},"runs_as":{},"workspace":{},"workspace_agent_id":{}}},"CredentialResult":{"properties":{"status":{"default":"issued","title":"Status","type":"string","enum":["issued"]},"tunnel_id":{"format":"uuid","title":"Tunnel Id","type":"string"},"connector_token":{"title":"Connector Token","type":"string"},"expires_at":{"format":"date-time","title":"Expires At","type":"string"},"gateway_url":{"title":"Gateway Url","type":"string"}},"required":["tunnel_id","connector_token","expires_at","gateway_url"],"title":"CredentialResult","type":"object"},"EnterpriseItem":{"description":"An enterprise as ``gen_serialize_enterprise`` emits it (ITEM).","properties":{"id":{"format":"uuid","title":"Id","type":"string"},"entity_type":{"title":"Entity Type","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"name":{"title":"Name","type":"string"}},"required":["id","entity_type","created_at","updated_at","name"],"title":"EnterpriseItem","type":"object"},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"Event":{"oneOf":[{"$ref":"#/components/schemas/EventContainerLog"},{"$ref":"#/components/schemas/EventAgentConsole"},{"$ref":"#/components/schemas/EventAgentInstallRequest"},{"$ref":"#/components/schemas/EventAgentNotificationError"},{"$ref":"#/components/schemas/EventAgentNotificationMessage"},{"$ref":"#/components/schemas/EventAgentNotificationProgress"},{"$ref":"#/components/schemas/EventAgentRender"},{"$ref":"#/components/schemas/EventCredentialsRequest"},{"$ref":"#/components/schemas/EventInterrupted"},{"$ref":"#/components/schemas/EventLlmDone"},{"$ref":"#/components/schemas/EventLlmStart"},{"$ref":"#/components/schemas/EventRuntimeDone"},{"$ref":"#/components/schemas/EventRuntimeError"},{"$ref":"#/components/schemas/EventRuntimeRunning"},{"$ref":"#/components/schemas/EventRuntimeStart"},{"$ref":"#/components/schemas/EventRuntimeWaiting"},{"$ref":"#/components/schemas/EventSecurity"},{"$ref":"#/components/schemas/EventSystemError"},{"$ref":"#/components/schemas/EventSystemMessage"},{"$ref":"#/components/schemas/EventTriggerMessage"},{"$ref":"#/components/schemas/EventUserMessage"}]},"EventAgentConsole":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"content":{"type":"string"},"level":{"type":"string","enum":["DEBUG","INFO","WARN","ERROR"]},"task_id":{"type":"string","format":"uuid"},"type":{}}},"EventAgentInstallRequest":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"requested_agent_id":{"type":"string","format":"uuid","description":"The agent requested to be installed"},"task_id":{"type":"string","format":"uuid"},"installed_agent_id":{"type":["string","null"],"format":"uuid","description":"The workspace agent created when this request was fulfilled"},"processed_at":{"type":["string","null"],"format":"date-time","description":"If the request has been declined, this is when it happened."},"processed_by_id":{"type":["string","null"],"format":"uuid","description":"The user who declined or accepted this request, if applicable."},"agent":{},"installed_agent":{},"is_fulfilled":{},"requested_agent":{},"type":{}}},"EventAgentNotificationError":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"content":{"type":"object"},"task_id":{"type":"string","format":"uuid"},"data":{},"type":{}}},"EventAgentNotificationMessage":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"content":{"type":"object"},"task_id":{"type":"string","format":"uuid"},"type":{}}},"EventAgentNotificationProgress":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"content":{"type":"object"},"task_id":{"type":"string","format":"uuid"},"type":{}}},"EventAgentRender":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"action_ids":{"type":"array","items":{},"description":"Every $action id in the tree, so a client event emission can be checked against the controls this render showed."},"content":{"type":"object","description":"json-render's flat spec: a root key, elements keyed by address, and the state object drafts write into."},"task_id":{"type":"string","format":"uuid"},"type":{}}},"EventContainerLog":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"task_id":{"type":"string","format":"uuid"},"level":{"type":["string","null"],"enum":["INFO","ERROR",null],"description":"Severity of the line: INFO for ordinary output, ERROR for error-level output. Nullable for now; pre-existing rows have no level."},"message":{"type":"string","maxLength":65536},"timestamp":{"type":"string","format":"date-time","description":"When the line was produced in the container (not received)"},"type":{}}},"EventCredentialsRequest":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"auth_config_id":{"type":"string","format":"uuid","description":"The auth config this credentials should use"},"task_id":{"type":"string","format":"uuid"},"is_fulfilled":{"type":"boolean","description":"Indicates whether the request has been fulfilled. Skipped requests are also marked fulfilled (see skipped_at). If it is set to true, credentials is null, and skipped_at is null, it means the credentials has been deleted later."},"credentials_id":{"type":["string","null"],"format":"uuid","description":"The credentials created when this request was fulfilled"},"skipped_at":{"type":["string","null"],"format":"date-time","description":"If the request was skipped, when it happened."},"skipped_by_id":{"type":["string","null"],"format":"uuid","description":"The user who skipped this request, if applicable."},"target_account_id":{"type":["string","null"],"format":"uuid","description":"The account the credentials should be installed in, if applicable. This is used by The Smith to request installs in other accounts."},"agent":{},"integration":{},"target_account":{},"type":{}}},"EventInterrupted":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"interrupted_at":{"type":"string","format":"date-time","description":"Timestamp when the session was interrupted"},"interrupted_by_id":{"type":"string","format":"uuid","description":"User who interrupted the session"},"task_id":{"type":"string","format":"uuid"},"interrupted_by":{},"type":{}}},"EventLlmDone":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"body":{"type":"string"},"headers":{"type":"object"},"llm_event_id":{"type":"string","format":"uuid"},"status_code":{"type":"integer"},"task_id":{"type":"string","format":"uuid"},"type":{}}},"EventLlmStart":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"headers":{"type":"object"},"inference_provider_id":{"type":"string","format":"uuid"},"llm_provider":{"type":"string","enum":["ANTHROPIC","OPENAI","GEMINI","FAKE_LLM","META","DEEPSEEK","ALIBABA","MOONSHOT","ZAI"]},"payload":{"type":"object"},"task_id":{"type":"string","format":"uuid"},"llm_model":{"type":["string","null"],"maxLength":100},"inference_provider":{},"model":{},"model_publisher":{},"type":{}}},"EventRuntimeDone":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"content":{"type":"object"},"task_id":{"type":"string","format":"uuid"},"type":{}}},"EventRuntimeError":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"content":{"type":"string"},"task_id":{"type":"string","format":"uuid"},"stack":{"type":["string","null"]},"type":{}}},"EventRuntimeRunning":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"task_id":{"type":"string","format":"uuid"},"type":{}}},"EventRuntimeStart":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"content":{"type":"object"},"task_id":{"type":"string","format":"uuid"},"type":{}}},"EventRuntimeWaiting":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"task_id":{"type":"string","format":"uuid"},"type":{}}},"EventSecurity":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"decision":{"type":"string","enum":["ALLOW","DENY","ERROR"],"description":"Security decision outcome."},"message":{"type":"string","maxLength":1024,"description":"Human-readable security event summary."},"operation":{"type":"string","maxLength":255,"description":"Integration operation or action evaluated."},"reason_code":{"type":"string","enum":["POLICY_DENIED","CREDENTIAL_UNAVAILABLE","PRIVILEGE_ESCALATION_DENIED","PLATFORM_ACCESS_DENIED","ACCESS_ALLOWED"],"description":"Stable machine code for why the decision occurred."},"task_id":{"type":"string","format":"uuid"},"acting_user_id":{"type":["string","null"],"format":"uuid","description":"Human acting on behalf of the task when the decision was recorded."},"capability":{"type":["string","null"],"maxLength":32,"description":"Capability evaluated for this decision (read, write, delete, admin)."},"credentials_id":{"type":["string","null"],"format":"uuid","description":"Credentials involved in the security decision when applicable."},"details":{"type":["object","null"],"description":"Optional structured audit context beyond task/session links."},"acting_user":{},"credentials":{},"integration":{},"task":{},"type":{}}},"EventSystemError":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"details":{"type":"object","description":"An arbitrary JSON object that stores details about the error."},"message":{"type":"string","maxLength":65536,"description":"A user-visible message that describes the error that occurred."},"task_id":{"type":"string","format":"uuid"},"content":{},"data":{},"type":{}}},"EventSystemMessage":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"content":{"type":"object"},"task_id":{"type":"string","format":"uuid"},"data":{},"type":{}}},"EventTriggerMessage":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"content":{"type":"object"},"task_id":{"type":"string","format":"uuid"},"data":{},"type":{}}},"EventType":{"enum":["user_message","agent_console","container_log","runtime_start","runtime_running","runtime_waiting","runtime_error","runtime_done","credentials_request","security_event","agent_install_request","agent_notification_message","agent_notification_progress","agent_notification_error","system_error","system_message","trigger_message","interrupted","llm_start","llm_done","agent_render"],"title":"EventType","type":"string"},"EventUserMessage":{"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":"Who sent this message: a user, or an account API key relaying a conversation on behalf of its account."},"content":{"type":"array","items":{}},"task_id":{"type":"string","format":"uuid"},"author":{},"content_parts":{},"type":{}}},"IntegrationCredentials":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"auth_config_id":{"type":"string","format":"uuid","description":"The auth config these credentials are for"},"creator_id":{"type":"string","format":"uuid","description":"Who added these credentials: a user, or an account API key"},"owner_id":{"type":"string","format":"uuid","description":"The account that owns these credentials"},"extra_data":{"type":["object","null"],"description":"Non-secret installation metadata the provider returned at connect time"},"params":{"type":["object","null"],"description":"The params in EntIntegrationParams user needs to provide during credentials linking"},"target_id":{"type":["string","null"],"format":"uuid","description":"Availability target. NULL means a plain account-pool credential. A workspace target homes the credential to that workspace: it serves agents there whose bindings did not resolve, and never appears in a sibling workspace's pool. An organization membership target binds the credential to that member in that organization. Ownership is always `owner`, never the target."},"webhook_owner_identifier":{"type":["string","null"],"maxLength":255},"config_params":{},"creator":{},"has_active_webhook_triggers":{},"integration":{},"policy_resources":{},"signature_type":{},"target":{},"webhook_enabled":{},"webhook_url":{}}},"Invitation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"creator_id":{"type":"string","format":"uuid","description":"The user who created this invitation."},"invitee_id":{"type":"string","format":"uuid","description":"The user who is being invited to the organization."},"organization_id":{"type":"string","format":"uuid","description":"The organization the invitee is being invited to."},"role":{"type":"string","enum":["ADMIN","MEMBER"],"description":"The role the invitee would have in the organization."},"status":{"type":"string","enum":["PENDING","CANCELED","DECLINED","ACCEPTED","EXPIRED"],"description":"The current status of the invitation."},"invitee":{},"type":{}}},"InvitationOrganization":{"oneOf":[{"$ref":"#/components/schemas/Invitation"},{"$ref":"#/components/schemas/InvitationOrganizationEmail"}]},"InvitationOrganizationEmail":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"creator_id":{"type":"string","format":"uuid","description":"The user who created this invitation."},"email":{"type":"string","format":"email"},"organization_id":{"type":"string","format":"uuid","description":"The organization the invitee is being invited to."},"role":{"type":"string","enum":["ADMIN","MEMBER"],"description":"The role the invitee would have in the organization."},"status":{"type":"string","enum":["PENDING","CANCELED","DECLINED","ACCEPTED","EXPIRED"],"description":"The current status of the invitation."},"delivery_id":{"type":["string","null"],"maxLength":255,"description":"A unique identifier returned by the email provider that idenfies the email uniquely in their system."},"invitee_id":{"type":["string","null"],"format":"uuid","description":"The user who accepted the invitation, once available."},"message":{"type":["string","null"],"maxLength":8192,"description":"An optional message from the inviter that will be sent along the invitation."},"invitee":{},"type":{}}},"Job":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"job_type":{"type":"string","enum":["VALIDATION","PUBLISH","PUBLISH_PRE_CHECK"]},"target_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["PENDING","RUNNING","SUCCEEDED","FAILED","ERRORED","CANCELLED"]},"completed_at":{"type":["string","null"],"format":"date-time"},"error_message":{"type":["string","null"],"maxLength":65536},"started_at":{"type":["string","null"],"format":"date-time"},"target":{}}},"JobStep":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"job_id":{"type":"string","format":"uuid"},"name":{"type":"string","maxLength":100,"description":"Step name (e.g., tsc, babel, dependencies)"},"status":{"type":"string","enum":["PENDING","RUNNING","SUCCEEDED","FAILED","SKIPPED","ERRORED"]},"completed_at":{"type":["string","null"],"format":"date-time"},"content":{"type":["string","null"]},"index":{"type":["integer","null"],"description":"The index of the step in the execution."},"started_at":{"type":["string","null"],"format":"date-time"},"job":{}}},"JobWait":{"allOf":[{"$ref":"#/components/schemas/Job"},{"$ref":"#/components/schemas/WaitCompletion"}]},"ManagedUserDetailed":{"description":"A managed user as ``gen_serialize_managed_user`` emits it (DETAILED).","properties":{"id":{"format":"uuid","title":"Id","type":"string"},"entity_type":{"title":"Entity Type","type":"string","enum":["EntManagedUser"]},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"name":{"title":"Name","type":"string"},"handle":{"title":"Handle","type":"string"},"full_name":{"title":"Full Name","type":["string","null"]},"avatar_url":{"title":"Avatar Url","type":["string","null"]},"enterprise_role":{"title":"Enterprise Role","type":["string","null"]},"enterprise":{"$ref":"#/components/schemas/EnterpriseItem"}},"required":["id","entity_type","created_at","updated_at","name","handle","full_name","avatar_url","enterprise_role","enterprise"],"title":"ManagedUserDetailed","type":"object"},"OauthIdentity":{"description":"Who an OAuth access token acts as: the consenting user, the client\nthat holds the token, and the scopes the user granted.","properties":{"type":{"title":"Type","type":"string","enum":["oauth"]},"user":{"additionalProperties":true,"description":"The consenting user (item shape).","title":"User","type":"object"},"client":{"additionalProperties":true,"description":"The OAuth client holding the token.","title":"Client","type":"object"},"scopes":{"description":"The granted scopes.","items":{"$ref":"#/components/schemas/ApiKeyScope"},"title":"Scopes","type":"array"}},"required":["type","user","client","scopes"],"title":"OauthIdentity","type":"object"},"Organization":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"creator_id":{"type":"string","format":"uuid","description":"The user who created this organization. Note that this does not give that user membership."},"name":{"type":"string","maxLength":100,"description":"The unique name identifying this account."},"cached_forks_count":{"type":"integer","description":"A cached version of the forks count. Might not be up to date."},"cached_forks_public_count":{"type":"integer","description":"A cached version of the forks count for public agents. Might not be up to date."},"cached_installs_count":{"type":"integer","description":"A cached version of the installs count. Might not be up to date."},"cached_installs_public_count":{"type":"integer","description":"A cached version of the installs count for public agents. Might not be up to date."},"cached_likes_count":{"type":"integer","description":"A cached version of the likes count. Might not be up to date."},"cached_likes_public_count":{"type":"integer","description":"A cached version of the likes count for public agents. Might not be up to date."},"avatar_url":{"type":["string","null"],"maxLength":255},"banner_url":{"type":["string","null"],"maxLength":255},"bio":{"type":["string","null"],"maxLength":255},"closure_requested_at":{"type":["string","null"],"format":"date-time","description":"Set when an admin asks support to close the account, so a repeated request does not email support again."},"closure_requested_by_id":{"type":["string","null"],"format":"uuid"},"discord_url":{"type":["string","null"],"maxLength":255},"email_domain":{"type":["string","null"],"maxLength":100,"description":"The email domain of the organization. Members will be automatically invited to this organization if they have an email with this domain."},"full_name":{"type":["string","null"],"maxLength":100,"description":"The display name of the account."},"github_url":{"type":["string","null"],"maxLength":255},"linkedin_url":{"type":["string","null"],"maxLength":255},"threads_url":{"type":["string","null"],"maxLength":255},"website_url":{"type":["string","null"],"maxLength":255},"x_url":{"type":["string","null"],"maxLength":255},"youtube_url":{"type":["string","null"],"maxLength":255},"member_count":{},"viewer_membership_id":{},"viewer_membership_public":{},"viewer_role":{"type":["string","null"],"enum":["ADMIN","MEMBER",null],"description":"Current viewer's role in the organization (null if not a member)"},"type":{"type":"string","enum":["organization"],"description":"Account type, always \"organization\""}}},"OrganizationMembership":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"is_public":{"type":"boolean","description":"Whether this membership is publicly visible."},"organization_id":{"type":"string","format":"uuid","description":"The organization this membership belongs to."},"role":{"type":"string","enum":["ADMIN","MEMBER"],"description":"The role of the user in the organization."},"user_id":{"type":"string","format":"uuid","description":"The user who is a member of this organization."},"email":{},"organization":{"$ref":"#/components/schemas/Organization"},"sign_in_methods":{},"user":{}}},"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"}}},"PaginationInfo":{"properties":{"total_count":{"description":"Items matching the request across all pages.","title":"Total Count","type":"integer"},"limit":{"description":"Page size of this response.","title":"Limit","type":"integer"},"offset":{"description":"Items skipped before this page.","title":"Offset","type":"integer"},"has_more":{"description":"Whether another page follows; request it with offset + limit.","title":"Has More","type":"boolean"}},"required":["total_count","limit","offset","has_more"],"title":"PaginationInfo","type":"object"},"PersonalUserItem":{"description":"A personal user as ``gen_serialize_personal_user`` emits it.","properties":{"id":{"format":"uuid","title":"Id","type":"string"},"entity_type":{"title":"Entity Type","type":"string","enum":["EntPersonalUser"]},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"type":{"title":"Type","type":"string","enum":["user"]},"name":{"title":"Name","type":"string"},"full_name":{"title":"Full Name","type":["string","null"]},"avatar_url":{"title":"Avatar Url","type":["string","null"]},"bio":{"title":"Bio","type":["string","null"]},"banner_url":{"title":"Banner Url","type":["string","null"]},"website_url":{"title":"Website Url","type":["string","null"]},"github_url":{"title":"Github Url","type":["string","null"]},"x_url":{"title":"X Url","type":["string","null"]},"linkedin_url":{"title":"Linkedin Url","type":["string","null"]},"discord_url":{"title":"Discord Url","type":["string","null"]},"youtube_url":{"title":"Youtube Url","type":["string","null"]},"threads_url":{"title":"Threads Url","type":["string","null"]},"cached_likes_public_count":{"title":"Cached Likes Public Count","type":"integer"},"cached_forks_public_count":{"title":"Cached Forks Public Count","type":"integer"},"cached_installs_public_count":{"title":"Cached Installs Public Count","type":"integer"},"email_domain":{"default":null,"title":"Email Domain","type":["string","null"]},"handle":{"title":"Handle","type":"string"}},"required":["id","entity_type","created_at","updated_at","type","name","full_name","avatar_url","bio","banner_url","website_url","github_url","x_url","linkedin_url","discord_url","youtube_url","threads_url","cached_likes_public_count","cached_forks_public_count","cached_installs_public_count","handle"],"title":"PersonalUserItem","type":"object"},"PublicMe":{"anyOf":[{"$ref":"#/components/schemas/ApiKey"},{"$ref":"#/components/schemas/OauthIdentity"}],"description":"``/v1/me`` answers for whichever credential called it; ``type``\ntells the two apart.","title":"PublicMe"},"RuntimeContainer":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"base_path":{"type":"string","maxLength":255,"description":"The base path on which the runtime's web server is exposed. Guildcore will call <host>/<base_path>/<start|resume>   "},"created_by_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"locked_for_session_id":{"type":["string","null"],"format":"uuid","description":"If set, only tasks in that specific session can use the runtime container, otherwise it can be shared within the workspace."},"runtime_environment_id":{"type":["string","null"],"format":"uuid","description":"The environment this container was created from, when one was named. Null for containers booted from a bare image."},"container_id":{},"created_by":{},"destroyed_at":{},"environment":{},"image":{},"started_at":{},"status":{},"workspace":{}}},"Session":{"oneOf":[{"$ref":"#/components/schemas/SessionAgentTest"},{"$ref":"#/components/schemas/SessionChat"},{"$ref":"#/components/schemas/SessionGateway"},{"$ref":"#/components/schemas/SessionScreen"},{"$ref":"#/components/schemas/SessionTriggerApi"},{"$ref":"#/components/schemas/SessionTriggerTime"},{"$ref":"#/components/schemas/SessionTriggerWebhook"}]},"SessionAgentTest":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"initiator_id":{"type":"string","format":"uuid","description":"Who started this agent test session: a user, or an account API key testing from CI."},"test_type":{"type":"string","enum":["MANUAL","EVAL"],"description":"Eval trials run as agent-test sessions; this separates them from sessions a person started from the agent editor."},"version_override_id":{"type":"string","format":"uuid","description":"The specific agent version being tested in this session."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace this session belongs to."},"context_id":{"type":["string","null"],"format":"uuid","description":"The context used in this session, if available."},"context_override_id":{"type":["string","null"],"format":"uuid","description":"Optional context override for testing purposes."},"interrupted_at":{"type":["string","null"],"format":"date-time","description":"Timestamp when this session was interrupted by a user. If set, no new messages can be sent and tasks cannot be executed."},"interrupted_by_id":{"type":["string","null"],"format":"uuid","description":"User who interrupted this session."},"profile_id":{"type":["string","null"],"format":"uuid","description":"Optional gateway profile governing this test session."},"seed_context":{"type":["string","null"],"maxLength":262144,"description":"Optional hidden pre-seed text for this session only, prepended to the agent's context on the first turn (e.g. the onboarding handoff tour transcript). Not a workspace context."}}},"SessionChat":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"initiator_id":{"type":"string","format":"uuid","description":"Who started this chat session: a user, or an account API key acting as its account."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace this session belongs to."},"archived_at":{"type":["string","null"],"format":"date-time"},"archived_by_id":{"type":["string","null"],"format":"uuid"},"assistant_version_id":{"type":["string","null"],"format":"uuid","description":"The assistant version resolved for this chat session. Null for legacy sessions and direct agent sessions that did not use the assistant."},"context_id":{"type":["string","null"],"format":"uuid","description":"The context used in this session, if available."},"interrupted_at":{"type":["string","null"],"format":"date-time","description":"Timestamp when this session was interrupted by a user. If set, no new messages can be sent and tasks cannot be executed."},"interrupted_by_id":{"type":["string","null"],"format":"uuid","description":"User who interrupted this session."},"name":{"type":["string","null"],"maxLength":100,"description":"The name/title of this chat session. Usually generated by an LLM based on the first prompt."},"origin":{"type":["string","null"],"enum":["CHAT","INSIGHTS",null],"description":"Set only on chats in a Smith workspace: CHAT for the Smith chat, INSIGHTS for a conversation the Ask Insights panel started. Chat lists filter on it to keep panel conversations out of the sidebar."},"seed_context":{"type":["string","null"],"maxLength":262144,"description":"Optional hidden pre-seed text for this session only, prepended to the agent's context on the first turn (e.g. the onboarding handoff tour transcript). Not a workspace context."}}},"SessionGateway":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"initiator_id":{"type":"string","format":"uuid","description":"The member whose calls this session carries. A profile an admin declares is used by everyone in the workspace, so sessions are per member rather than per profile."},"ip_address":{"type":"string","maxLength":45,"description":"The IP address of the client which initiated this session."},"profile_id":{"type":"string","format":"uuid","description":"The gateway profile this session's calls run as. Names the install directly, rather than leaving it to be inferred from the agent version, which several profiles share."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace this session belongs to."},"context_id":{"type":["string","null"],"format":"uuid","description":"The context used in this session, if available."},"interrupted_at":{"type":["string","null"],"format":"date-time","description":"Timestamp when this session was interrupted by a user. If set, no new messages can be sent and tasks cannot be executed."},"interrupted_by_id":{"type":["string","null"],"format":"uuid","description":"User who interrupted this session."},"seed_context":{"type":["string","null"],"maxLength":262144,"description":"Optional hidden pre-seed text for this session only, prepended to the agent's context on the first turn (e.g. the onboarding handoff tour transcript). Not a workspace context."},"user_agent":{"type":["string","null"],"maxLength":1024,"description":"The User-Agent of the connecting client, naming the assistant driving this profile. Unset when the client sends no header."}}},"SessionScreen":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"install_id":{"type":"string","format":"uuid","description":"The installed UI agent this screen renders. Unique: an install has one screen for good, so the session id a page holds is stable and two racing first opens cannot both create one."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace this session belongs to."},"context_id":{"type":["string","null"],"format":"uuid","description":"The context used in this session, if available."},"interrupted_at":{"type":["string","null"],"format":"date-time","description":"Timestamp when this session was interrupted by a user. If set, no new messages can be sent and tasks cannot be executed."},"interrupted_by_id":{"type":["string","null"],"format":"uuid","description":"User who interrupted this session."},"seed_context":{"type":["string","null"],"maxLength":262144,"description":"Optional hidden pre-seed text for this session only, prepended to the agent's context on the first turn (e.g. the onboarding handoff tour transcript). Not a workspace context."}}},"SessionTriggerApi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"api_key_id":{"type":"string","format":"uuid","description":"The API key which initiated this session."},"ip_address":{"type":"string","maxLength":45,"description":"The IP address of the client which initiated this session."},"trigger_id":{"type":"string","format":"uuid","description":"The trigger that initiated this session."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace this session belongs to."},"context_id":{"type":["string","null"],"format":"uuid","description":"The context used in this session, if available."},"interrupted_at":{"type":["string","null"],"format":"date-time","description":"Timestamp when this session was interrupted by a user. If set, no new messages can be sent and tasks cannot be executed."},"interrupted_by_id":{"type":["string","null"],"format":"uuid","description":"User who interrupted this session."},"seed_context":{"type":["string","null"],"maxLength":262144,"description":"Optional hidden pre-seed text for this session only, prepended to the agent's context on the first turn (e.g. the onboarding handoff tour transcript). Not a workspace context."}}},"SessionTriggerTime":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"trigger_id":{"type":"string","format":"uuid","description":"The trigger that initiated this session."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace this session belongs to."},"context_id":{"type":["string","null"],"format":"uuid","description":"The context used in this session, if available."},"interrupted_at":{"type":["string","null"],"format":"date-time","description":"Timestamp when this session was interrupted by a user. If set, no new messages can be sent and tasks cannot be executed."},"interrupted_by_id":{"type":["string","null"],"format":"uuid","description":"User who interrupted this session."},"seed_context":{"type":["string","null"],"maxLength":262144,"description":"Optional hidden pre-seed text for this session only, prepended to the agent's context on the first turn (e.g. the onboarding handoff tour transcript). Not a workspace context."}}},"SessionTriggerWebhook":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"integration_webhook_id":{"type":"string","format":"uuid","description":"The webhook that triggered this session."},"trigger_id":{"type":"string","format":"uuid","description":"The webhook trigger that initiated this session."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace this session belongs to."},"context_id":{"type":["string","null"],"format":"uuid","description":"The context used in this session, if available."},"interrupted_at":{"type":["string","null"],"format":"date-time","description":"Timestamp when this session was interrupted by a user. If set, no new messages can be sent and tasks cannot be executed."},"interrupted_by_id":{"type":["string","null"],"format":"uuid","description":"User who interrupted this session."},"remote_id":{"type":["string","null"],"maxLength":255,"description":"Remote identifier for correlating related events to this session."},"seed_context":{"type":["string","null"],"maxLength":262144,"description":"Optional hidden pre-seed text for this session only, prepended to the agent's context on the first turn (e.g. the onboarding handoff tour transcript). Not a workspace context."}}},"Skill":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"is_public":{"type":"boolean","description":"Whether the asset is visible to the community or only its owner."},"name":{"type":"string","maxLength":100,"description":"Unique name identifying the asset within the owner account."},"owner_id":{"type":"string","format":"uuid","description":"The account that owns this entity."},"archived_at":{"type":["string","null"],"format":"date-time"},"archived_by_id":{"type":["string","null"],"format":"uuid"},"avatar_url":{"type":["string","null"],"maxLength":255},"creator_id":{"type":["string","null"],"format":"uuid","description":"The user or API key that created this skill. Null for legacy rows created before creator attribution was recorded."},"overview":{"type":["string","null"],"maxLength":8192,"description":"Optional human-facing overview for display and indexing. Falls back to the latest version description if not set."},"archived_by":{},"creator":{},"full_name":{},"last_updated_by":{},"latest_version":{},"likes_count":{},"owner":{},"type":{},"viewer_can_edit":{}}},"SkillDetail":{"description":"A skill as ``gen_serialize_skill`` emits it. ``full_name``,\n``likes_count`` and ``viewer_can_edit`` are computed at serialization\ntime and exist on no entity.","properties":{"id":{"format":"uuid","title":"Id","type":"string"},"entity_type":{"title":"Entity Type","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"type":{"title":"Type","type":"string","enum":["skill"]},"full_name":{"title":"Full Name","type":"string"},"name":{"maxLength":100,"title":"Name","type":"string"},"overview":{"title":"Overview","maxLength":8192,"type":["string","null"]},"is_public":{"title":"Is Public","type":"boolean"},"avatar_url":{"title":"Avatar Url","maxLength":255,"type":["string","null"]},"archived_at":{"title":"Archived At","format":"date-time","type":["string","null"]},"owner":{"$ref":"#/components/schemas/AccountItem"},"likes_count":{"title":"Likes Count","type":"integer"},"viewer_can_edit":{"title":"Viewer Can Edit","type":"boolean"},"archived_by":{"anyOf":[{"$ref":"#/components/schemas/AccountItem"},{"enum":[null]}]},"latest_version":{"anyOf":[{"$ref":"#/components/schemas/SkillVersionItem"},{"enum":[null]}]}},"required":["id","entity_type","created_at","updated_at","type","full_name","name","overview","is_public","avatar_url","archived_at","owner","likes_count","viewer_can_edit","archived_by","latest_version"],"title":"SkillDetail","type":"object"},"SkillVersion":{"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":"The user or API key that created this skill version."},"body":{"type":"string","maxLength":262144,"description":"Full markdown content for this skill version."},"description":{"type":"string","maxLength":8192,"description":"Runtime-facing description that tells the LLM when to activate this skill."},"skill_id":{"type":"string","format":"uuid","description":"The skill this version belongs to."},"version_number":{"type":"string","maxLength":64,"description":"The semantic version number (MAJOR.MINOR.PATCH)."},"author":{},"skill":{},"type":{}}},"SkillVersionItem":{"description":"A skill version as ``gen_serialize_skill_version`` emits it (ITEM).","properties":{"id":{"format":"uuid","title":"Id","type":"string"},"entity_type":{"title":"Entity Type","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"type":{"title":"Type","type":"string","enum":["skill_version"]},"version_number":{"title":"Version Number","type":"integer"},"description":{"title":"Description","type":["string","null"]}},"required":["id","entity_type","created_at","updated_at","type","version_number","description"],"title":"SkillVersionItem","type":"object"},"Task":{"oneOf":[{"$ref":"#/components/schemas/TaskAgent"},{"$ref":"#/components/schemas/TaskTool"}]},"TaskAgent":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"session_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["CREATED","DISPATCHED","STARTED","RUNNING","WAITING","ERROR","DONE","INTERRUPTED"]},"deferred_start":{"type":["object","null"],"description":"The {input, env} /start payload for a container-hosted agent whose run is held until its container's setup phase completes; set when the run is deferred and replayed when /start is dispatched from the setup-complete callback. Retained afterward as the record of the run's starting input (overwritten on the next deferred turn), not cleared."},"notified_at":{"type":["string","null"],"format":"date-time","description":"Date and time when this task output was sent to the runtime.\n                This should be None if the task is not DONE or ERROR, or if the\n                runtime hasn't been resumed yet."},"parent_task_id":{"type":["string","null"],"format":"uuid"},"runtime_id":{"type":["string","null"],"format":"uuid","description":"An optional runtime, if the agent is not run in the default Guild runtime."},"saved_state":{"type":["string","null"]},"span_id":{"description":"Span id of the single invoke_agent span that covers this agent task across all of its start/resume executions."},"trace_id":{},"version_id":{"type":["string","null"],"format":"uuid","description":"The version of the agent that this task is running. If None, it means we're running the assistant."},"agent":{},"cache_read_tokens":{},"cache_write_tokens":{},"input_tokens":{},"llm_call_count":{},"output_tokens":{},"parent_task":{},"token_usage":{},"total_tokens":{},"version":{}}},"TaskTool":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"parent_task_id":{"type":"string","format":"uuid"},"session_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["CREATED","DISPATCHED","STARTED","RUNNING","WAITING","ERROR","DONE","INTERRUPTED"]},"tool_call_id":{"type":"string"},"tool_name":{"type":"string","maxLength":255},"http_status_code":{"type":["integer","null"],"description":"The HTTP response code of the response"},"notified_at":{"type":["string","null"],"format":"date-time","description":"Date and time when this task output was sent to the runtime.\n                This should be None if the task is not DONE or ERROR, or if the\n                runtime hasn't been resumed yet."},"request_bytes":{"type":["integer","null"],"description":"The number of bytes in the outgoing request"},"response_bytes":{"type":["integer","null"],"description":"The number of bytes in the response"},"response_data":{"type":["string","null"],"description":"Full JSON response body, stored only when the response was projected due to size"},"parent_task":{},"token_usage":{}}},"TimeTriggerFrequency":{"enum":["HOURLY","DAILY","WEEKLY","MONTHLY","CRON"],"title":"TimeTriggerFrequency","type":"string"},"User":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"email":{"type":"string","maxLength":100},"name":{"type":"string","maxLength":100,"description":"The unique name identifying this account."},"cached_forks_count":{"type":"integer","description":"A cached version of the forks count. Might not be up to date."},"cached_forks_public_count":{"type":"integer","description":"A cached version of the forks count for public agents. Might not be up to date."},"cached_installs_count":{"type":"integer","description":"A cached version of the installs count. Might not be up to date."},"cached_installs_public_count":{"type":"integer","description":"A cached version of the installs count for public agents. Might not be up to date."},"cached_likes_count":{"type":"integer","description":"A cached version of the likes count. Might not be up to date."},"cached_likes_public_count":{"type":"integer","description":"A cached version of the likes count for public agents. Might not be up to date."},"is_operator":{"type":"boolean","description":"Whether or not the user is a Guild employee (or operator). BE VERY CAREFUL WITH THIS."},"notification_email_level":{"type":"string","enum":["NONE","IMPORTANT","ALL"],"description":"NONE = no emails, IMPORTANT = invitations and agent-ask only, ALL = all notification types."},"avatar_url":{"type":["string","null"],"maxLength":255},"banner_url":{"type":["string","null"],"maxLength":255},"bio":{"type":["string","null"],"maxLength":255},"closed_at":{"type":["string","null"],"format":"date-time","description":"Set when an operator closes the account. A closed user cannot start a login session by any method."},"closure_requested_at":{"type":["string","null"],"format":"date-time","description":"Set when an admin asks support to close the account, so a repeated request does not email support again."},"closure_requested_by_id":{"type":["string","null"],"format":"uuid"},"discord_url":{"type":["string","null"],"maxLength":255},"email_verified_at":{"type":["string","null"],"format":"date-time","description":"Set once the user has proven they own `email`: a magic link to it was used, or an OAuth provider reported it verified."},"full_name":{"type":["string","null"],"maxLength":100,"description":"The display name of the account."},"github_url":{"type":["string","null"],"maxLength":255},"hubspot_synced_at":{"type":["string","null"],"format":"date-time"},"linkedin_url":{"type":["string","null"],"maxLength":255},"threads_url":{"type":["string","null"],"maxLength":255},"username_set_at":{"type":["string","null"],"format":"date-time","description":"Set when the user picks their username during onboarding. Once set, the username cannot be changed."},"website_url":{"type":["string","null"],"maxLength":255},"x_url":{"type":["string","null"],"maxLength":255},"youtube_url":{"type":["string","null"],"maxLength":255},"handle":{"type":"string","description":"Names the user in `/users/<handle>`; a personal user's handle is their name"},"type":{"type":"string","enum":["user"],"description":"Account type, always \"user\""}}},"UserProfile":{"description":"A personal or managed user; ``entity_type`` tells the two apart.","discriminator":{"mapping":{"EntManagedUser":"#/components/schemas/ManagedUserDetailed","EntPersonalUser":"#/components/schemas/PersonalUserItem"},"propertyName":"entity_type"},"oneOf":[{"$ref":"#/components/schemas/PersonalUserItem"},{"$ref":"#/components/schemas/ManagedUserDetailed"}],"title":"UserProfile"},"WaitAction":{"properties":{"type":{"enum":["user_input","credentials","agent_install"],"title":"Type","type":"string"},"task_id":{"title":"Task Id","type":"string"},"event":{"default":null,"title":"Event","additionalProperties":true,"type":["object","null"]}},"required":["type","task_id"],"title":"WaitAction","type":"object"},"WaitCompletion":{"type":"object","properties":{"wait_complete":{"type":"boolean","description":"Whether the operation completed before the optional wait timeout."}},"required":["wait_complete"]},"WaitForSessionResponse":{"properties":{"session_id":{"title":"Session Id","type":"string"},"task_id":{"title":"Task Id","type":"string"},"user_event_id":{"title":"User Event Id","type":"string"},"after_event_id":{"title":"After Event Id","type":"string"},"completion_scope":{"title":"Completion Scope","type":"string","enum":["root_task_state"]},"message_consumed":{"title":"Message Consumed","type":"string","enum":["unconfirmed"]},"wait_complete":{"title":"Wait Complete","type":"boolean"},"status":{"default":null,"title":"Status","type":["string","null"]},"event":{"default":null,"title":"Event","additionalProperties":true,"type":["object","null"]},"action":{"default":null,"anyOf":[{"$ref":"#/components/schemas/WaitAction"},{"enum":[null]}]}},"required":["session_id","task_id","user_event_id","after_event_id","completion_scope","message_consumed","wait_complete"],"title":"WaitForSessionResponse","type":"object"},"Workspace":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"creator_id":{"type":"string","format":"uuid"},"name":{"type":"string","maxLength":100},"owner_id":{"type":"string","format":"uuid","description":"The account that owns this entity."},"restrict_account_credentials":{"type":"boolean","description":"When true, tasks in this workspace may not fall back to the owning account's shared credential pool: a resolution that would reach the account default is refused so the workspace must rely on credentials granted or connected to its agents."},"should_restrict_members":{"type":"boolean","description":"When true, only workspace members (plus org admins of the owning org) can access this workspace; when false, it is open to the whole owning org."},"unlimited_power_mode":{"type":"boolean","description":"When true, this workspace's execution-tree fan-out limits are raised to the platform ceilings instead of the default budgets. The limits are raised, not removed. https://i.ibb.co/5XsvmfKg/CFD5-C99-C-B322-46-A2-9892-AFDF484-D28-E1-1.webp"},"archived_at":{"type":["string","null"],"format":"date-time"},"archived_by_id":{"type":["string","null"],"format":"uuid"},"required_credentials_mode":{"type":["string","null"],"enum":["SHARED","MEMBER",null],"description":"Whose credentials agents in this workspace may run with: SHARED = only org-side credentials serve, MEMBER = only the acting member's own. Unset = no requirement. A workspace agent's own declaration overrides this one."},"archived_by":{},"creator":{},"full_name":{"type":"string","description":"Full workspace name in format \"owner_name~workspace_name\""},"is_viewer_member":{},"owner":{"$ref":"#/components/schemas/Account"},"unlimited_power_mode_enabled":{}}},"WorkspaceAgent":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"creator_id":{"type":"string","format":"uuid","description":"The user or API key that added this agent version to the workspace."},"version_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"is_default_chat_agent":{"type":"boolean","description":"If True, this workspace agent is used for new chat sessions when no explicit agent is provided."},"should_autoupdate":{"type":"boolean","description":"If True, the agent will automatically update when a new version is published."},"archived_at":{"type":["string","null"],"format":"date-time"},"archived_by_id":{"type":["string","null"],"format":"uuid"},"profile_name":{"type":["string","null"],"maxLength":100,"description":"Set when this install is an MCP gateway profile, addressed as /workspaces/<workspace>/mcp/<profile_name>. Unset on ordinary agent installs."},"required_credentials_mode":{"type":["string","null"],"enum":["SHARED","MEMBER",null],"description":"Whose credentials this agent may run with: SHARED = only org-side credentials serve, MEMBER = only the acting member's own. Unset = the workspace's declaration applies, and no requirement when that is unset too."},"agent":{"$ref":"#/components/schemas/Agent"},"agent_version":{"$ref":"#/components/schemas/AgentVersion"},"creator":{"$ref":"#/components/schemas/User"},"workspace":{"$ref":"#/components/schemas/Workspace"}}},"WorkspaceAgentUpgrade":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"new_version_id":{"type":"string","format":"uuid"},"old_version_id":{"type":"string","format":"uuid"},"workspace_agent_id":{"type":"string","format":"uuid"},"author_id":{"type":["string","null"],"format":"uuid","description":"If applicable, the person who upgraded the agent. Null means the agent was automatically upgraded."},"author":{},"new_version":{},"old_version":{}}},"WorkspaceItem":{"description":"A workspace as ``gen_serialize_workspace`` emits it.","properties":{"id":{"format":"uuid","title":"Id","type":"string"},"entity_type":{"title":"Entity Type","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"name":{"maxLength":100,"title":"Name","type":"string"},"full_name":{"title":"Full Name","type":"string"},"owner":{"$ref":"#/components/schemas/AccountItem"},"creator":{"description":"Whoever created the workspace: a user, an account API key, or a trigger key (actor item shape).","title":"Creator","additionalProperties":true,"type":["object","null"]},"should_restrict_members":{"title":"Should Restrict Members","type":"boolean"},"unlimited_power_mode":{"title":"Unlimited Power Mode","type":"boolean"},"unlimited_power_mode_enabled":{"title":"Unlimited Power Mode Enabled","type":"boolean"},"restrict_account_credentials":{"title":"Restrict Account Credentials","type":"boolean"},"required_credentials_mode":{"title":"Required Credentials Mode","type":["string","null"]},"is_viewer_member":{"title":"Is Viewer Member","type":"boolean"},"archived_at":{"title":"Archived At","format":"date-time","type":["string","null"]},"archived_by":{"anyOf":[{"$ref":"#/components/schemas/AccountItem"},{"enum":[null]}]}},"required":["id","entity_type","created_at","updated_at","name","full_name","owner","creator","should_restrict_members","unlimited_power_mode","unlimited_power_mode_enabled","restrict_account_credentials","required_credentials_mode","is_viewer_member","archived_at","archived_by"],"title":"WorkspaceItem","type":"object"},"WorkspaceList":{"description":"The pagination envelope every collection endpoint returns.","properties":{"items":{"items":{"$ref":"#/components/schemas/WorkspaceItem"},"title":"Items","type":"array"},"pagination":{"$ref":"#/components/schemas/PaginationInfo"}},"required":["items","pagination"],"title":"WorkspaceList","type":"object"},"WorkspaceMembership":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"added_by_id":{"type":"string","format":"uuid","description":"The user who added this member."},"user_id":{"type":"string","format":"uuid","description":"The user who is a member of this workspace."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace this membership belongs to."},"added_by":{},"user":{}}},"WorkspaceSkill":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"creator_id":{"type":"string","format":"uuid","description":"The user or API key that added this skill to the workspace."},"skill_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"archived_at":{"type":["string","null"],"format":"date-time"},"archived_by_id":{"type":["string","null"],"format":"uuid"},"creator":{},"skill":{},"type":{},"workspace":{}}},"WorkspaceTrigger":{"oneOf":[{"$ref":"#/components/schemas/WorkspaceTriggerApi"},{"$ref":"#/components/schemas/WorkspaceTriggerTime"},{"$ref":"#/components/schemas/WorkspaceTriggerWebhook"}]},"WorkspaceTriggerApi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"agent_id":{"type":"string","format":"uuid","description":"The workspace agent to run when the trigger is activated."},"name":{"type":"string","maxLength":255,"description":"Human-readable label identifying the trigger within its workspace."},"workspace_id":{"type":"string","format":"uuid"},"creator_id":{"type":["string","null"],"format":"uuid","description":"The actor (a user or an account API key) that created this trigger. Null for legacy rows created before creator attribution was recorded."},"deactivated_at":{"type":["string","null"],"format":"date-time","description":"If set, indicates when the trigger has been deactivated."},"type":{"type":"string","enum":["api"],"description":"Trigger type discriminator"},"agent":{"$ref":"#/components/schemas/Agent"},"workspace_agent":{"$ref":"#/components/schemas/WorkspaceAgent"}}},"WorkspaceTriggerTime":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"agent_id":{"type":"string","format":"uuid","description":"The workspace agent to run when the trigger is activated."},"agent_input":{"type":"object","description":"The input that should be passed to the agent when the trigger\nis executed. It must match the input schema of the agent being triggerred."},"frequency":{"type":"string","enum":["HOURLY","DAILY","WEEKLY","MONTHLY","CRON"]},"name":{"type":"string","maxLength":255,"description":"Human-readable label identifying the trigger within its workspace."},"next_run_at":{"type":"string","format":"date-time","description":"When should the next run happen?"},"workspace_id":{"type":"string","format":"uuid"},"creator_id":{"type":["string","null"],"format":"uuid","description":"The actor (a user or an account API key) that created this trigger. Null for legacy rows created before creator attribution was recorded."},"cron_expression":{"type":["string","null"],"maxLength":100,"description":"Standard 5-field cron expression. Only used with CRON frequency."},"cron_timezone":{"type":["string","null"],"maxLength":50,"description":"IANA timezone for cron evaluation (e.g. America/Los_Angeles). If omitted or None, cron evaluation uses UTC."},"days_of_month":{"type":["array","null"],"items":{},"description":"None for non-MONTHLY frequency. List of days: [1, 8, 16]."},"days_of_week":{"type":["array","null"],"items":{},"description":"None for non-WEEKLY frequency. List of days: [\"MONDAY\", \"TUESDAY\"]."},"deactivated_at":{"type":["string","null"],"format":"date-time","description":"If set, indicates when the trigger has been deactivated."},"minutes_of_hour":{"type":["array","null"],"items":{},"description":"For HOURLY frequency only. Defaults to on the hour. List of minutes: [0, 15, 30, 45]."},"time_of_day":{"description":"None for `HOURLY` frequency. If not provided, will default to 9am."},"type":{"type":"string","enum":["time"],"description":"Trigger type discriminator"},"agent":{"$ref":"#/components/schemas/Agent"},"workspace_aget":{"$ref":"#/components/schemas/WorkspaceAgent"}}},"WorkspaceTriggerWebhook":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"agent_id":{"type":"string","format":"uuid","description":"The workspace agent to run when the trigger is activated."},"name":{"type":"string","maxLength":255,"description":"Human-readable label identifying the trigger within its workspace."},"webhook_config_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"action":{"type":["string","null"],"maxLength":100,"description":"Optional action filter. If null, matches all actions."},"agent_input":{"type":["object","null"]},"creator_id":{"type":["string","null"],"format":"uuid","description":"The actor (a user or an account API key) that created this trigger. Null for legacy rows created before creator attribution was recorded."},"credentials_id":{"type":["string","null"],"format":"uuid"},"deactivated_at":{"type":["string","null"],"format":"date-time","description":"If set, indicates when the trigger has been deactivated."},"event_type":{"type":["string","null"],"maxLength":100,"description":"The type of webhook event (e.g., 'pull_request', 'push').\nIf null, matches all events."},"service_config":{"type":["object","null"]},"integration":{},"type":{"type":"string","enum":["webhook"],"description":"Trigger type discriminator"},"agent":{"$ref":"#/components/schemas/Agent"},"workspace_aget":{"$ref":"#/components/schemas/WorkspaceAgent"}}},"_AttachmentContentPart":{"properties":{"type":{"enum":["image","file"],"title":"Type","type":"string"},"attachment_id":{"format":"uuid","title":"Attachment Id","type":"string"}},"required":["type","attachment_id"],"title":"_AttachmentContentPart","type":"object"},"_MultimodalContentPart":{"discriminator":{"mapping":{"file":"#/components/schemas/_AttachmentContentPart","image":"#/components/schemas/_AttachmentContentPart","text":"#/components/schemas/_TextContentPart"},"propertyName":"type"},"oneOf":[{"$ref":"#/components/schemas/_TextContentPart"},{"$ref":"#/components/schemas/_AttachmentContentPart"}]},"_TextContentPart":{"properties":{"type":{"title":"Type","type":"string","enum":["text"]},"text":{"title":"Text","type":"string"}},"required":["type","text"],"title":"_TextContentPart","type":"object"}},"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"}},"SortBy":{"name":"sort_by","in":"query","required":false,"schema":{"default":null,"description":"Column name to sort by. Timestamp and integer columns sort largest first (newest first for created_at), other columns ascending; prefix with '-' to reverse, e.g. -created_at for oldest first.","title":"Sort By","type":["string","null"]}}},"securitySchemes":{"apiKey":{"type":"http","scheme":"basic","description":"API key: key id as the username, secret as the password. An account API key carries the same scopes as an OAuth token and is checked against the scopes listed under oauth2 on each operation. A trigger API key is limited to its trigger's workspace and reaches only the session operations that list this scheme alongside the oauth2 scopes."},"bearerApiKey":{"type":"http","scheme":"bearer","bearerFormat":"<key id>:<secret>","description":"The same API key as one Bearer token, `<key id>:<secret>`. An account API key carries the same scopes as an OAuth token and is checked against the scopes listed under oauth2 on each operation. A trigger API key is limited to its trigger's workspace and reaches only the session operations that list this scheme alongside the oauth2 scopes."},"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","usage:read":"Read usage","usage:write":"Read and change usage","evals:read":"Read evals","evals:write":"Read and change evals"}}}},"connectorToken":{"type":"http","scheme":"bearer","description":"Customer connector credential: the enrollment token to enroll, then the connector token it returns."}},"headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window. Present when a rate limit applies to the request.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests left in the current window. Present when a rate limit applies to the request.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window ends. Present when a rate limit applies to the request.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying. Present when a rate limit applies to the request.","schema":{"type":"integer"}}},"responses":{"TooManyRequests":{"description":"Too Many Requests","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}