{"openapi":"3.1.0","info":{"title":"dropexpired API","version":"2.0.0-dev","description":"REST binding of the dropexpired operation registry (/v1). The same operations are available over GraphQL at /graphql and as MCP tools."},"servers":[{"url":"/"}],"security":[{"bearer":[]}],"tags":[{"name":"service"},{"name":"auth"},{"name":"me"},{"name":"api-keys"},{"name":"search"},{"name":"accounts"},{"name":"collections"},{"name":"teams"},{"name":"public"},{"name":"billing"},{"name":"orders"},{"name":"domains"},{"name":"lists"},{"name":"agent"}],"paths":{"/health":{"get":{"operationId":"system.health","tags":["service"],"summary":"Health","description":"Liveness / readiness of the API and its data stores.","security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["ready","degraded"]},"version":{"type":"string"},"mode":{"type":"string","enum":["mock","real"]},"mockMode":{"type":"boolean"},"checks":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["ready","unavailable"]}},"required":["status"]}}},"required":["status","version","mode","mockMode","checks"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"}},"x-toolset":"system","x-safety":"read","x-tenancy":"public","x-mcp-tool":"system_health"}},"/v1/meta/capabilities":{"get":{"operationId":"system.capabilities","tags":["service"],"summary":"Capabilities","description":"Mode, toolsets with operation counts, provider ports and which providers are configured, and API limits.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string"},"toolsets":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"operations":{"type":"integer"}},"required":["name","operations"]}},"providers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"ports":{"type":"array","items":{"type":"string"}},"configured":{"type":"boolean"}},"required":["id","kind","ports","configured"]}},"limits":{"type":"object","additionalProperties":false,"properties":{"maxPageSize":{"type":"integer"},"maxFileBytes":{"type":"integer"},"rateLimitPerMinute":{"type":"integer"},"jobRateLimitPerMinute":{"type":"integer"}},"required":["maxPageSize","maxFileBytes","rateLimitPerMinute","jobRateLimitPerMinute"]}},"required":["mode","toolsets","providers","limits"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"system","x-safety":"read","x-tenancy":"user","x-mcp-tool":"system_capabilities"}},"/v1/meta/operations":{"get":{"operationId":"system.operations","tags":["service"],"summary":"Operation catalog","description":"Machine-readable catalog of the operations the caller may use (filtered by API-key policy); the MCP server builds its tools from it.","parameters":[{"name":"mcpOnly","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"version":{"type":"string"},"operations":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"operationId":{"type":"string","description":"operationId in the OpenAPI contract"},"implemented":{"type":"boolean","description":"false: declared in the contract, answers 501 NOT_IMPLEMENTED"},"group":{"type":"string"},"toolset":{"type":"string"},"safety":{"type":"string"},"readOnlyJob":{"type":"boolean"},"tenancy":{"type":"string"},"summary":{"type":"string"},"description":{"type":"string"},"input":{"type":"object"},"output":{},"rest":{"type":["object","null"]},"graphql":{"type":["object","null"]},"mcp":{"type":["object","null"]},"list":{"type":["object","null"],"description":"List operations: entity, filterable/sortable fields, default sort (query params filter/sort/fields/limit/cursor)."}},"required":["id","toolset","safety","input","rest","mcp"]}}},"required":["version","operations"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"system","x-safety":"read","x-tenancy":"user"}},"/v1/auth/signup":{"post":{"operationId":"signUp","tags":["auth"],"summary":"Sign up","description":"Creates an account with email + password (min 10 characters) and signs it in. 409 ACCOUNT_EXISTS when the email is taken.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","format":"email","maxLength":320},"password":{"type":"string","minLength":10,"maxLength":200},"locale":{"type":"string","maxLength":16}},"required":["email","password"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"accessToken":{"type":"string"},"refreshToken":{"type":"string","description":"Native apps only; the web gets an httpOnly cookie"},"tokenType":{"type":"string","enum":["Bearer"]},"expiresIn":{"type":"integer"},"expiresAt":{"type":"string","format":"date-time"},"user":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"email":{"type":"string"},"emailVerified":{"type":"boolean"},"identities":{"type":"array","items":{"type":"string","enum":["email","google","apple","github"]}},"settings":{"type":"object","additionalProperties":false,"properties":{"locale":{"type":"string","enum":["system","en","ru","th","zh","hi"]},"theme":{"type":"string","enum":["system","light","dark"]},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"agentMayCreateLists":{"type":"boolean"},"aiTrainingOptOut":{"type":"boolean","description":"`true` stops the use of your future assistant requests and answers to improve and train our own assistant models."},"notifications":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"boolean"},"push":{"type":"boolean"}}}}},"planId":{"type":"string"},"displayName":{"type":"string"},"workspaceRole":{"type":"string","enum":["admin","member"]},"via":{"type":"string","enum":["jwt","apiKey","internal"]},"keyId":{"type":["string","null"]}},"required":["id","email","identities","settings","planId"]}},"required":["accessToken","expiresIn","user"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"}},"x-toolset":"auth","x-safety":"write","x-tenancy":"public"}},"/v1/auth/login":{"post":{"operationId":"signIn","tags":["auth"],"summary":"Sign in","description":"Exchanges email + password for an access JWT (ES256, 15 min) and a rotating refresh token (30 d): httpOnly cookie on the web, body for native apps (`X-DX-Client: native`).","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","format":"email","maxLength":320},"password":{"type":"string","minLength":1,"maxLength":200}},"required":["email","password"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"accessToken":{"type":"string"},"refreshToken":{"type":"string","description":"Native apps only; the web gets an httpOnly cookie"},"tokenType":{"type":"string","enum":["Bearer"]},"expiresIn":{"type":"integer"},"expiresAt":{"type":"string","format":"date-time"},"user":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"email":{"type":"string"},"emailVerified":{"type":"boolean"},"identities":{"type":"array","items":{"type":"string","enum":["email","google","apple","github"]}},"settings":{"type":"object","additionalProperties":false,"properties":{"locale":{"type":"string","enum":["system","en","ru","th","zh","hi"]},"theme":{"type":"string","enum":["system","light","dark"]},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"agentMayCreateLists":{"type":"boolean"},"aiTrainingOptOut":{"type":"boolean","description":"`true` stops the use of your future assistant requests and answers to improve and train our own assistant models."},"notifications":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"boolean"},"push":{"type":"boolean"}}}}},"planId":{"type":"string"},"displayName":{"type":"string"},"workspaceRole":{"type":"string","enum":["admin","member"]},"via":{"type":"string","enum":["jwt","apiKey","internal"]},"keyId":{"type":["string","null"]}},"required":["id","email","identities","settings","planId"]}},"required":["accessToken","expiresIn","user"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"}},"x-toolset":"auth","x-safety":"write","x-tenancy":"public"}},"/v1/auth/refresh":{"post":{"operationId":"refresh","tags":["auth"],"summary":"Refresh","description":"Rotates the refresh token (body for native apps, else the `dx_refresh` cookie) and returns a new access JWT; reusing a rotated token revokes the whole login.","security":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"refreshToken":{"type":"string","minLength":10,"maxLength":200}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"accessToken":{"type":"string"},"refreshToken":{"type":"string","description":"Native apps only; the web gets an httpOnly cookie"},"tokenType":{"type":"string","enum":["Bearer"]},"expiresIn":{"type":"integer"},"expiresAt":{"type":"string","format":"date-time"},"user":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"email":{"type":"string"},"emailVerified":{"type":"boolean"},"identities":{"type":"array","items":{"type":"string","enum":["email","google","apple","github"]}},"settings":{"type":"object","additionalProperties":false,"properties":{"locale":{"type":"string","enum":["system","en","ru","th","zh","hi"]},"theme":{"type":"string","enum":["system","light","dark"]},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"agentMayCreateLists":{"type":"boolean"},"aiTrainingOptOut":{"type":"boolean","description":"`true` stops the use of your future assistant requests and answers to improve and train our own assistant models."},"notifications":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"boolean"},"push":{"type":"boolean"}}}}},"planId":{"type":"string"},"displayName":{"type":"string"},"workspaceRole":{"type":"string","enum":["admin","member"]},"via":{"type":"string","enum":["jwt","apiKey","internal"]},"keyId":{"type":["string","null"]}},"required":["id","email","identities","settings","planId"]}},"required":["accessToken","expiresIn","user"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"}},"x-toolset":"auth","x-safety":"write","x-tenancy":"public"}},"/v1/auth/logout":{"post":{"operationId":"signOut","tags":["auth"],"summary":"Sign out","description":"Revokes the current login (its access and refresh tokens) and clears the web refresh cookie.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"auth","x-safety":"write","x-tenancy":"user"}},"/v1/auth/password/reset":{"post":{"operationId":"requestPasswordReset","tags":["auth"],"summary":"Request password reset","description":"Mails a one-time reset link (1 h) if the account exists; always answers 204 (does not reveal whether the email is registered).","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","format":"email","maxLength":320}},"required":["email"]}}}},"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"}},"x-toolset":"auth","x-safety":"write","x-tenancy":"public"}},"/v1/auth/password/reset/confirm":{"post":{"operationId":"confirmPasswordReset","tags":["auth"],"summary":"Confirm password reset","description":"Sets a new password with the token from the reset link; every login session is signed out.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":10,"maxLength":200},"password":{"type":"string","minLength":10,"maxLength":200}},"required":["token","password"]}}}},"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"}},"x-toolset":"auth","x-safety":"write","x-tenancy":"public"}},"/v1/auth/oauth/{provider}/start":{"get":{"operationId":"oauthStart","tags":["auth"],"summary":"Oauth start","description":"Redirects (302) to Google / Apple / GitHub; the provider returns to `redirect` with `?code=&state=` for oauthExchange. 503 NOT_CONFIGURED for a provider without a client id.","security":[],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","enum":["google","apple","github"]}},{"name":"redirect","in":"query","required":true,"schema":{"type":"string","format":"uri","maxLength":2000}}],"responses":{"302":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string"}},"required":["url"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}},"x-toolset":"auth","x-safety":"read","x-tenancy":"public"}},"/v1/auth/oauth/{provider}/exchange":{"post":{"operationId":"oauthExchange","tags":["auth"],"summary":"Oauth exchange","description":"Signs in with the redirect `code` + `state`, or a native id token (Google / Apple, with its `nonce`). A new email creates the account; an email that already has an account answers 409 ACCOUNT_EXISTS (sign in and link the provider).","security":[],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","enum":["google","apple","github"]}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","minLength":1,"maxLength":2048},"state":{"type":"string","minLength":1,"maxLength":200},"idToken":{"type":"string","minLength":1,"maxLength":8192},"nonce":{"type":"string","minLength":1,"maxLength":200}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"accessToken":{"type":"string"},"refreshToken":{"type":"string","description":"Native apps only; the web gets an httpOnly cookie"},"tokenType":{"type":"string","enum":["Bearer"]},"expiresIn":{"type":"integer"},"expiresAt":{"type":"string","format":"date-time"},"user":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"email":{"type":"string"},"emailVerified":{"type":"boolean"},"identities":{"type":"array","items":{"type":"string","enum":["email","google","apple","github"]}},"settings":{"type":"object","additionalProperties":false,"properties":{"locale":{"type":"string","enum":["system","en","ru","th","zh","hi"]},"theme":{"type":"string","enum":["system","light","dark"]},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"agentMayCreateLists":{"type":"boolean"},"aiTrainingOptOut":{"type":"boolean","description":"`true` stops the use of your future assistant requests and answers to improve and train our own assistant models."},"notifications":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"boolean"},"push":{"type":"boolean"}}}}},"planId":{"type":"string"},"displayName":{"type":"string"},"workspaceRole":{"type":"string","enum":["admin","member"]},"via":{"type":"string","enum":["jwt","apiKey","internal"]},"keyId":{"type":["string","null"]}},"required":["id","email","identities","settings","planId"]}},"required":["accessToken","expiresIn","user"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"}},"x-toolset":"auth","x-safety":"write","x-tenancy":"public"}},"/v1/me":{"get":{"operationId":"me","tags":["me"],"summary":"Me","description":"The signed-in user: identities, settings, plan; plus the workspace role and how the call was authenticated.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"email":{"type":"string"},"emailVerified":{"type":"boolean"},"identities":{"type":"array","items":{"type":"string","enum":["email","google","apple","github"]}},"settings":{"type":"object","additionalProperties":false,"properties":{"locale":{"type":"string","enum":["system","en","ru","th","zh","hi"]},"theme":{"type":"string","enum":["system","light","dark"]},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"agentMayCreateLists":{"type":"boolean"},"aiTrainingOptOut":{"type":"boolean","description":"`true` stops the use of your future assistant requests and answers to improve and train our own assistant models."},"notifications":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"boolean"},"push":{"type":"boolean"}}}}},"planId":{"type":"string"},"displayName":{"type":"string"},"workspaceRole":{"type":"string","enum":["admin","member"]},"via":{"type":"string","enum":["jwt","apiKey","internal"]},"keyId":{"type":["string","null"]}},"required":["id","email","identities","settings","planId"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"read","x-tenancy":"user"},"patch":{"operationId":"updateSettings","tags":["me"],"summary":"Update settings","description":"Updates the user settings (locale, theme, spending limit, agent permissions, notifications); returns Me.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"locale":{"type":"string","enum":["system","en","ru","th","zh","hi"]},"theme":{"type":"string","enum":["system","light","dark"]},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"agentMayCreateLists":{"type":"boolean"},"aiTrainingOptOut":{"type":"boolean","description":"`true` stops the use of your future assistant requests and answers to improve and train our own assistant models."},"notifications":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"boolean"},"push":{"type":"boolean"}}}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"email":{"type":"string"},"emailVerified":{"type":"boolean"},"identities":{"type":"array","items":{"type":"string","enum":["email","google","apple","github"]}},"settings":{"type":"object","additionalProperties":false,"properties":{"locale":{"type":"string","enum":["system","en","ru","th","zh","hi"]},"theme":{"type":"string","enum":["system","light","dark"]},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"agentMayCreateLists":{"type":"boolean"},"aiTrainingOptOut":{"type":"boolean","description":"`true` stops the use of your future assistant requests and answers to improve and train our own assistant models."},"notifications":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"boolean"},"push":{"type":"boolean"}}}}},"planId":{"type":"string"},"displayName":{"type":"string"},"workspaceRole":{"type":"string","enum":["admin","member"]},"via":{"type":"string","enum":["jwt","apiKey","internal"]},"keyId":{"type":["string","null"]}},"required":["id","email","identities","settings","planId"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"write","x-tenancy":"user"},"delete":{"operationId":"deleteAccount","tags":["me"],"summary":"Delete account","description":"Deletes the account: signs out every session, revokes the API keys, removes identities and devices and frees the email.","responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"write","x-tenancy":"user"}},"/v1/me/ai-training-data":{"delete":{"operationId":"deleteAiTrainingData","tags":["me"],"summary":"Delete my AI training samples","description":"Deletes the pseudonymised samples of your earlier assistant requests and answers that were kept to improve and train our own assistant models. To stop new samples, set `aiTrainingOptOut` in the settings.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"deleted":{"type":"integer","minimum":0}},"required":["deleted"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"write","x-tenancy":"user"}},"/v1/me/identities":{"post":{"operationId":"linkIdentity","tags":["me"],"summary":"Link identity","description":"Links a Google / Apple / GitHub sign-in (redirect `code` + `state`, or a native `idToken`) to the account; 409 when it belongs to another account.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"provider":{"type":"string","enum":["google","apple","github"]},"code":{"type":"string","minLength":1,"maxLength":2048},"state":{"type":"string","minLength":1,"maxLength":200},"idToken":{"type":"string","minLength":1,"maxLength":8192},"nonce":{"type":"string","minLength":1,"maxLength":200}},"required":["provider"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"email":{"type":"string"},"emailVerified":{"type":"boolean"},"identities":{"type":"array","items":{"type":"string","enum":["email","google","apple","github"]}},"settings":{"type":"object","additionalProperties":false,"properties":{"locale":{"type":"string","enum":["system","en","ru","th","zh","hi"]},"theme":{"type":"string","enum":["system","light","dark"]},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"agentMayCreateLists":{"type":"boolean"},"aiTrainingOptOut":{"type":"boolean","description":"`true` stops the use of your future assistant requests and answers to improve and train our own assistant models."},"notifications":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"boolean"},"push":{"type":"boolean"}}}}},"planId":{"type":"string"},"displayName":{"type":"string"},"workspaceRole":{"type":"string","enum":["admin","member"]},"via":{"type":"string","enum":["jwt","apiKey","internal"]},"keyId":{"type":["string","null"]}},"required":["id","email","identities","settings","planId"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"write","x-tenancy":"user"}},"/v1/me/devices":{"post":{"operationId":"registerDevice","tags":["me"],"summary":"Register device","description":"Registers (or moves to this user) a push token (FCM) of an app installation.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"platform":{"type":"string","enum":["ios","android","web","macos","windows","linux"]},"token":{"type":"string","minLength":8,"maxLength":4096}},"required":["platform","token"]}}}},"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"write","x-tenancy":"user"}},"/v1/me/usage":{"get":{"operationId":"usage","tags":["me"],"summary":"Usage","description":"Usage against the limits of the plan of the context (personal, or the X-Team-Id team): metered limits reset at 00:00 UTC; counted limits (watch lists, wishes, alerts, …) are current counts.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"planId":{"type":"string"},"items":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"string"},"used":{"type":"integer"},"max":{"type":["integer","null"]},"resetAt":{"type":["string","null"],"format":"date-time"}},"required":["limit","used"]}}},"required":["planId","items"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"read","x-tenancy":"user","x-mcp-tool":"plan_usage"}},"/v1/me/entitlement":{"get":{"operationId":"entitlement","tags":["me"],"summary":"Entitlement","description":"Effective plan of the context (personal, or X-Team-Id: max(team, owner's plan)): paying channel (comps: none), status (grace after a failed payment), period end, cancellation, manage URL and every live subscription across channels (highest plan wins).","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"planId":{"type":"string"},"channel":{"type":"string","enum":["none","stripe","app_store","play"]},"status":{"type":"string","enum":["none","active","trialing","grace"]},"renewsAt":{"type":["string","null"],"format":"date-time"},"periodEnd":{"type":["string","null"],"format":"date-time"},"graceUntil":{"type":["string","null"],"format":"date-time"},"cancelAt":{"type":["string","null"],"format":"date-time"},"manageUrl":{"type":["string","null"]},"subscriptions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"channel":{"type":"string","enum":["stripe","app_store","play","manual"]},"planId":{"type":"string"},"status":{"type":"string"},"interval":{"type":["string","null"],"enum":["monthly","yearly",null]},"periodEnd":{"type":["string","null"],"format":"date-time"},"cancelAt":{"type":["string","null"],"format":"date-time"},"graceUntil":{"type":["string","null"],"format":"date-time"},"manageUrl":{"type":["string","null"]}},"required":["channel","planId","status"]}}},"required":["planId","channel"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"read","x-tenancy":"user"}},"/v1/api-keys":{"get":{"operationId":"apiKeys","tags":["api-keys"],"summary":"Api keys","description":"Active API keys of the context: personal, or the X-Team-Id team's (secrets are never returned again).","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]},"secret":{"type":"string","description":"Only returned once, on creation"}},"required":["id","name","prefix","createdAt"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"api_keys","x-safety":"read","x-tenancy":"user"},"post":{"operationId":"createApiKey","tags":["api-keys"],"summary":"Create api key","description":"Creates a key `dx_live_…` for the REST API and MCP (plan feature `api`, else 402 FEATURE_LOCKED); with X-Team-Id a team key (admin+, the team plan). The secret is returned once.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":60}},"required":["name"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]},"secret":{"type":"string","description":"Only returned once, on creation"}},"required":["id","name","prefix","createdAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"api_keys","x-safety":"write","x-tenancy":"user"}},"/v1/api-keys/{id}":{"delete":{"operationId":"revokeApiKey","tags":["api-keys"],"summary":"Revoke api key","description":"Revokes an API key of the context (personal, or the X-Team-Id team's: admin+) immediately.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"api_keys","x-safety":"write","x-tenancy":"user"}},"/v1/meta/toolsets":{"get":{"operationId":"system.toolsets","tags":["service"],"summary":"List toolsets and presets","description":"Toolsets with operation counts per safety class and the policy presets (service key policies are `off | read | full` per toolset).","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"toolsets":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"operations":{"type":"integer"},"readOperations":{"type":"integer"},"fullOnlyOperations":{"type":"integer"},"bySafety":{"type":"object","additionalProperties":{"type":"integer"}}},"required":["name","operations","readOperations","fullOnlyOperations","bySafety"]}},"presets":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"system":{"type":"string","enum":["off","read","full"]},"checks":{"type":"string","enum":["off","read","full"]},"discovery":{"type":"string","enum":["off","read","full"]},"archive":{"type":"string","enum":["off","read","full"]},"snapshots":{"type":"string","enum":["off","read","full"]},"crawl":{"type":"string","enum":["off","read","full"]},"metrics":{"type":"string","enum":["off","read","full"]},"serp":{"type":"string","enum":["off","read","full"]},"jobs":{"type":"string","enum":["off","read","full"]},"connections":{"type":"string","enum":["off","read","full"]},"files":{"type":"string","enum":["off","read","full"]},"public":{"type":"string","enum":["off","read","full"]},"search":{"type":"string","enum":["off","read","full"]},"lists":{"type":"string","enum":["off","read","full"]},"domains":{"type":"string","enum":["off","read","full"]},"collections":{"type":"string","enum":["off","read","full"]},"orders":{"type":"string","enum":["off","read","full"]},"accounts":{"type":"string","enum":["off","read","full"]},"agent":{"type":"string","enum":["off","read","full"]},"auth":{"type":"string","enum":["off","read","full"]},"me":{"type":"string","enum":["off","read","full"]},"billing":{"type":"string","enum":["off","read","full"]},"teams":{"type":"string","enum":["off","read","full"]},"api_keys":{"type":"string","enum":["off","read","full"]}}}}},"required":["toolsets","presets"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"system","x-safety":"read","x-tenancy":"user","x-mcp-tool":"system_toolsets"}},"/v1/oauth/requests/{id}":{"get":{"operationId":"oauthRequest","tags":["me"],"summary":"OAuth request","description":"A pending OAuth authorization (consent page): the app, whether dropexpired verified it, its redirect host and the scopes asked.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":8,"maxLength":80,"pattern":"^dxq_[A-Za-z0-9]+$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"client":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"verified":{"type":"boolean"},"uri":{"type":["string","null"]},"logoUri":{"type":["string","null"]}},"required":["id","name","verified"]},"redirectHost":{"type":"string"},"scopes":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"text":{"type":"string"}},"required":["id","text"]}},"resource":{"type":["string","null"]},"expiresAt":{"type":"string","format":"date-time"}},"required":["id","client","redirectHost","scopes","expiresAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"read","x-tenancy":"user"}},"/v1/oauth/requests/{id}/approve":{"post":{"operationId":"oauthApprove","tags":["me"],"summary":"Approve OAuth request","description":"Grants the app the asked scopes for you (or a team where you are admin or owner: teamId) and returns the redirect back to it.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":8,"maxLength":80,"pattern":"^dxq_[A-Za-z0-9]+$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"teamId":{"type":"string","minLength":1,"maxLength":64}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"redirect":{"type":"string"}},"required":["redirect"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"write","x-tenancy":"user"}},"/v1/oauth/requests/{id}/deny":{"post":{"operationId":"oauthDeny","tags":["me"],"summary":"Deny OAuth request","description":"Refuses the authorization; returns the redirect back to the app with access_denied.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":8,"maxLength":80,"pattern":"^dxq_[A-Za-z0-9]+$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"redirect":{"type":"string"}},"required":["redirect"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"write","x-tenancy":"user"}},"/v1/me/oauth-grants":{"get":{"operationId":"oauthGrants","tags":["me"],"summary":"Connected apps","description":"Apps you connected through OAuth (personal and team grants you made), with their scopes and last use.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"client":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"verified":{"type":"boolean"},"uri":{"type":["string","null"]},"logoUri":{"type":["string","null"]}},"required":["id","name","verified"]},"scopes":{"type":"array","items":{"type":"string"}},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]},"createdAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","client","scopes","owner","createdAt"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"read","x-tenancy":"user"}},"/v1/me/oauth-grants/{id}":{"delete":{"operationId":"revokeOauthGrant","tags":["me"],"summary":"Disconnect app","description":"Revokes a connected app at once: its access and refresh tokens stop working.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":36,"maxLength":36}}],"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"write","x-tenancy":"user"}},"/v1/ai-answers/visibility":{"post":{"operationId":"aiVisibility","tags":["search"],"summary":"AI-answer visibility","description":"Who the AI answer engines (`engines`) name and cite for your queries: per engine, mentions (position) and citations of your domain and competitors. Your own connected AI account first (no limits); else ours: Free reads cached answers only, paid plans call the engines (daily / monthly units). pending: call again in a minute.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"queries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":300},"minItems":1,"maxItems":20},"engines":{"type":"array","items":{"type":"string","enum":["chatgpt","perplexity","yandex","deepseek"]},"maxItems":4},"domain":{"type":"string","minLength":3,"maxLength":253,"pattern":"^[A-Za-z0-9.-]+\\.[A-Za-z]{2,}$"},"competitors":{"type":"array","items":{"type":"string","minLength":3,"maxLength":253,"pattern":"^[A-Za-z0-9.-]+\\.[A-Za-z]{2,}$"},"maxItems":10},"lang":{"type":"string","minLength":2,"maxLength":5},"country":{"type":"string","minLength":2,"maxLength":2},"fresh":{"type":"boolean"}},"required":["queries"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"string"},"engine":{"type":"string","enum":["chatgpt","perplexity","yandex","deepseek"]},"status":{"type":"string","enum":["ok","not_cached","not_configured","budget","quota","own_key_error","error","pending"]},"cached":{"type":"boolean"},"account":{"type":["string","null"],"enum":["ours","own",null]},"asOf":{"type":["string","null"],"format":"date-time"},"mentions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"position":{"type":["integer","null"]},"cited":{"type":"boolean"}},"required":["domain","position","cited"]}},"citations":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string"},"domain":{"type":"string"},"position":{"type":"integer"}},"required":["url","domain","position"]}},"excerpt":{"type":["string","null"]},"reason":{"type":"string"}},"required":["query","engine","status","cached","account","asOf","mentions","citations","excerpt"]}},"summary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"engines":{"type":"object","additionalProperties":{"type":"object"}}},"required":["domain","engines"]}}},"required":["results","summary"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"search","x-safety":"read","x-tenancy":"user","x-mcp-tool":"ai_visibility"}},"/v1/me/ai-connections":{"get":{"operationId":"aiConnections","tags":["accounts"],"summary":"Your AI accounts","description":"Your connected AI accounts (one per `provider`) used by AI-answer visibility without dropexpired limits. Keys are never returned.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["openai","perplexity","yandex_cloud","deepseek"]},"engine":{"type":["string","null"]},"status":{"type":"string","enum":["untested","ok","invalid_key","error"]},"maskedKey":{"type":["string","null"]},"lastError":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"lastVerifiedAt":{"type":["string","null"],"format":"date-time"},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]}},"required":["id","provider","status","createdAt","owner"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"accounts","x-safety":"read","x-tenancy":"user","x-mcp-tool":"accounts_ai_list"},"post":{"operationId":"connectAiAccount","tags":["accounts"],"summary":"Connect an AI account","description":"Stores your key of an AI provider (vault; tested at once with one short question on your account). One account per provider; a new key replaces the old. credentials: apiKey (yandex_cloud: apiKey + folderId).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"provider":{"type":"string","enum":["openai","perplexity","yandex_cloud","deepseek"]},"credentials":{"type":"object","additionalProperties":{"type":"string","maxLength":4096},"maxProperties":4,"writeOnly":true}},"required":["provider","credentials"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["openai","perplexity","yandex_cloud","deepseek"]},"engine":{"type":["string","null"]},"status":{"type":"string","enum":["untested","ok","invalid_key","error"]},"maskedKey":{"type":["string","null"]},"lastError":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"lastVerifiedAt":{"type":["string","null"],"format":"date-time"},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]}},"required":["id","provider","status","createdAt","owner"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"accounts","x-safety":"write","x-tenancy":"user"}},"/v1/me/ai-connections/{id}/verify":{"post":{"operationId":"verifyAiAccount","tags":["accounts"],"summary":"Test an AI account","description":"Asks one short question on the connected account; status becomes ok, invalid_key or error.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["openai","perplexity","yandex_cloud","deepseek"]},"engine":{"type":["string","null"]},"status":{"type":"string","enum":["untested","ok","invalid_key","error"]},"maskedKey":{"type":["string","null"]},"lastError":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"lastVerifiedAt":{"type":["string","null"],"format":"date-time"},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]}},"required":["id","provider","status","createdAt","owner"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"accounts","x-safety":"write","x-tenancy":"user"}},"/v1/me/ai-connections/{id}":{"delete":{"operationId":"disconnectAiAccount","tags":["accounts"],"summary":"Remove an AI account","description":"Deletes the connection and its key from the vault.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}}],"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"accounts","x-safety":"write","x-tenancy":"user"}},"/v1/jobs":{"get":{"operationId":"jobs.list","tags":["service"],"summary":"List jobs","description":"Lists jobs (newest first) with filters on kind, status, owner and clientRef.","parameters":[{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[<field>][<op>]=<value>; ops: eq, ne, gt, gte, lt, lte, in, nin, contains, prefix, between, isnull. Fields: `id` (string), `kind` (string), `status` (string), `ownerKind` (string), `ownerId` (string), `clientRef` (string), `createdAt` (date), `progressPct` (integer).","schema":{"type":"object","additionalProperties":true}},{"name":"sort","in":"query","description":"Comma list, `-` prefix for descending; aliases accepted.","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Sparse field selection; aliases accepted.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"jobs","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"jobs_list"}},"/v1/jobs/{id}":{"get":{"operationId":"jobs.get","tags":["service"],"summary":"Get job status","description":"Returns a job; `wait` (0-30 s) long-polls until its status or progress changes.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":30,"default":0}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"jobs","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"jobs_get"}},"/v1/jobs/{id}/result":{"get":{"operationId":"jobs.result","tags":["service"],"summary":"Get job result","description":"Returns the result of a finished job; 409 JOB_NOT_DONE while it is still running or failed.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"jobId":{"type":"string"},"kind":{"type":"string"},"result":{}},"required":["jobId","kind","result"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"jobs","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"jobs_result"}},"/v1/jobs/{id}/logs":{"get":{"operationId":"jobs.logs","tags":["service"],"summary":"Get job log lines","description":"Returns log lines of a job, optionally only those after sequence number `after`.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"after","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"seq":{"type":"integer"},"line":{"type":"string"},"level":{"type":"string","enum":["info","warn","error","ok"]},"loggedAt":{"type":"string","format":"date-time"}},"required":["seq","line","level","loggedAt"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"jobs","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"jobs_logs"}},"/v1/jobs/{id}/actions/cancel":{"post":{"operationId":"jobs.cancel","tags":["service"],"summary":"Cancel a job","description":"Cancels a queued or running job (409 INVALID_TRANSITION if already finished).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"jobs","x-safety":"write","x-tenancy":"workspace","x-mcp-tool":"jobs_cancel"}},"/v1/jobs/{id}/actions/retry":{"post":{"operationId":"jobs.retry","tags":["service"],"summary":"Retry a job","description":"Re-queues a failed or cancelled job with the same input.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"jobs","x-safety":"write","x-tenancy":"workspace","x-mcp-tool":"jobs_retry"}},"/v1/jobs/{id}/events":{"get":{"operationId":"jobs.events","tags":["service"],"summary":"Stream job events (SSE)","description":"Server-Sent Events stream: status, progress, log and done events for one job; closes after done.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"200":{"description":"Server-Sent Events stream","content":{"text/event-stream":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"jobs","x-safety":"read","x-tenancy":"workspace"}},"/v1/webhooks":{"get":{"operationId":"jobs.webhooks_list","tags":["service"],"summary":"List webhook subscriptions","description":"Webhook subscriptions of the current user (job.done / job.failed / job.cancelled).","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["job.done","job.failed","job.cancelled"]}},"createdAt":{"type":"string","format":"date-time"},"secret":{"type":"string","description":"Signing secret, returned only on creation"}},"required":["id","url","events","createdAt"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"jobs","x-safety":"read","x-tenancy":"user","x-mcp-tool":"jobs_webhooks_list"},"post":{"operationId":"jobs.webhooks_create","tags":["service"],"summary":"Subscribe a webhook","description":"Registers a URL that receives HMAC-signed events of the caller's jobs; the signing secret is returned once.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":2000},"events":{"type":"array","items":{"type":"string","enum":["job.done","job.failed","job.cancelled"]},"minItems":1,"uniqueItems":true,"default":["job.done","job.failed"]}},"required":["url"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["job.done","job.failed","job.cancelled"]}},"createdAt":{"type":"string","format":"date-time"},"secret":{"type":"string","description":"Signing secret, returned only on creation"}},"required":["id","url","events","createdAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"jobs","x-safety":"write","x-tenancy":"user","x-mcp-tool":"jobs_webhooks_create"}},"/v1/webhooks/{id}":{"delete":{"operationId":"jobs.webhooks_delete","tags":["service"],"summary":"Delete a webhook subscription","description":"Stops deliveries to a webhook URL.\n\nRequires `confirm: true`; without it the API answers 428 with a dry-run preview.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"confirm","in":"query","required":false,"schema":{"type":"boolean","description":"Must be true to execute; otherwise 428 with a dry-run preview."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["job.done","job.failed","job.cancelled"]}},"createdAt":{"type":"string","format":"date-time"},"secret":{"type":"string","description":"Signing secret, returned only on creation"}},"required":["id","url","events","createdAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"428":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"jobs","x-safety":"destructive","x-tenancy":"user","x-mcp-tool":"jobs_webhooks_delete"}},"/v1/files":{"post":{"operationId":"files.upload","tags":["service"],"summary":"Upload a file","description":"Uploads evidence/import/export files (≤ 20 MB multipart field \"file\"; JSON {name, mime, base64} ≤ 5 MB). Types: png, jpeg, webp, gif, pdf, csv, xlsx, xml.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"purpose":{"type":"string","enum":["evidence","import","export","avatar","research"],"default":"evidence"},"name":{"type":"string","maxLength":255},"mime":{"type":"string","maxLength":120},"base64":{"type":"string","maxLength":7000000}}}},"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream"},"purpose":{"type":"string","enum":["evidence","import","export","avatar","research"],"default":"evidence"},"name":{"type":"string","maxLength":255},"mime":{"type":"string","maxLength":120},"base64":{"type":"string","maxLength":7000000}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"integer","minimum":0},"sha256":{"type":"string"},"purpose":{"type":"string","enum":["evidence","import","export","avatar","research"]},"createdBy":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","name","mime","size","sha256","purpose","createdAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"files","x-safety":"write","x-tenancy":"workspace","x-mcp-tool":"files_upload"}},"/v1/files/{id}":{"get":{"operationId":"files.get","tags":["service"],"summary":"Get file metadata","description":"Returns metadata of an uploaded or generated file.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"integer","minimum":0},"sha256":{"type":"string"},"purpose":{"type":"string","enum":["evidence","import","export","avatar","research"]},"createdBy":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","name","mime","size","sha256","purpose","createdAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"files","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"files_get"},"delete":{"operationId":"files.delete","tags":["service"],"summary":"Delete a file","description":"Deletes file metadata and content.\n\nRequires `confirm: true`; without it the API answers 428 with a dry-run preview.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"confirm","in":"query","required":false,"schema":{"type":"boolean","description":"Must be true to execute; otherwise 428 with a dry-run preview."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"integer","minimum":0},"sha256":{"type":"string"},"purpose":{"type":"string","enum":["evidence","import","export","avatar","research"]},"createdBy":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","name","mime","size","sha256","purpose","createdAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"428":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"files","x-safety":"destructive","x-tenancy":"workspace","x-mcp-tool":"files_delete"}},"/v1/files/{id}/content":{"get":{"operationId":"files.content","tags":["service"],"summary":"Download file content","description":"Streams the file bytes with its content type (attachment).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"200":{"description":"Raw bytes","content":{"application/octet-stream":{"schema":{"type":"string","contentEncoding":"binary"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"files","x-safety":"read","x-tenancy":"workspace"}},"/v1/discovery/finds":{"post":{"operationId":"discovery.find_start","tags":["service"],"summary":"Start a domain find","description":"Finds candidate domains by method: `serp` (keyword), `commoncrawl`, `outbound_links` (seedUrl), `manual_import` (domains), `drop_list` and `marketplace` (filters: zone, trust/tf, authority/dr, refDomains/rd, age, price…). Results land in the domain registry.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"method":{"type":"string","enum":["serp","commoncrawl","outbound_links","manual_import","drop_list","marketplace"]},"keyword":{"type":"string","minLength":1,"maxLength":200},"seedUrl":{"type":"string","minLength":3,"maxLength":1000},"domains":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300},"minItems":1,"maxItems":5000},"filters":{"type":"object","additionalProperties":false,"properties":{"zone":{"type":"array","items":{"type":"string","maxLength":30},"maxItems":30},"trust":{"type":"object","additionalProperties":false,"properties":{"gte":{"type":"number"},"lte":{"type":"number"}}},"authority":{"type":"object","additionalProperties":false,"properties":{"gte":{"type":"number"},"lte":{"type":"number"}}},"refDomains":{"type":"object","additionalProperties":false,"properties":{"gte":{"type":"number"},"lte":{"type":"number"}}},"ageYears":{"type":"object","additionalProperties":false,"properties":{"gte":{"type":"number"},"lte":{"type":"number"}}},"archivePages":{"type":"object","additionalProperties":false,"properties":{"gte":{"type":"number"},"lte":{"type":"number"}}},"priceUsd":{"type":"object","additionalProperties":false,"properties":{"gte":{"type":"number"},"lte":{"type":"number"}}},"dropWithinDays":{"type":"integer","minimum":0,"maximum":365},"marketplaceKinds":{"type":"array","items":{"type":"string","enum":["auction","backorder","closeout","buy_now"]}}},"x-aliases":true},"limit":{"type":"integer","minimum":1,"maximum":500,"default":50},"gl":{"type":"string","minLength":2,"maxLength":2,"description":"serp: country code of the search (default us)"},"depth":{"type":"integer","minimum":10,"maximum":100,"description":"serp: results per keyword (default 90)"},"collection":{"type":"string","pattern":"^CC-MAIN-[0-9]{4}-[0-9]{2}$","description":"`commoncrawl`: crawl collection (default: the latest one)"},"maxPages":{"type":"integer","minimum":1,"maximum":200,"description":"outbound_links: pages to crawl on the seed site (default 20)"},"callbackUrl":{"type":"string","format":"uri","maxLength":2000},"clientRef":{"type":"string","minLength":1,"maxLength":200}},"required":["method"]}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"discovery","x-safety":"job","x-tenancy":"workspace","x-read-only-job":true,"x-mcp-tool":"discovery_find_start"}},"/v1/discovery/finds/{jobId}":{"get":{"operationId":"discovery.find_result","tags":["service"],"summary":"Get domain-find results","description":"Candidates of a finished find job with context, listing and whether each domain is new to the registry.","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"method":{"type":"string"},"items":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"domainUnicode":{"type":"string"},"registryId":{"type":"string"},"discoveredVia":{"type":"string"},"context":{"type":"string"},"isNew":{"type":"boolean"},"listing":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string"},"kind":{"type":"string","enum":["auction","backorder","closeout","buy_now"]},"endsAt":{"type":["string","null"]},"priceUsd":{"type":"number"},"bids":{"type":"integer"}},"required":["source","kind","endsAt","priceUsd","bids"]},{"type":"null"}]}},"required":["domain","domainUnicode","registryId","discoveredVia","context","isNew","listing"]}},"stats":{"type":"object","description":"Counters of the find, such as queries, cachedQueries, pages, blocks, bytes, domains, newDomains"}},"required":["method","items"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"discovery","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"discovery_find_result"}},"/v1/registry":{"get":{"operationId":"discovery.registry_search","tags":["service"],"summary":"Search the domain registry","description":"All discovered domains (checked or not) with filters on zone, category, method, expiry, registrar.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[<field>][<op>]=<value>; ops: eq, ne, gt, gte, lt, lte, in, nin, contains, prefix, between, isnull. Fields: `id` (string), `domain` (string), `zone` (string), `category` (string), `discoveredVia` (string), `discoveredAt` (date), `expirationDate` (date), `registrar` (string), `lastCheckedAt` (date), `keyword` (string).","schema":{"type":"object","additionalProperties":true}},{"name":"sort","in":"query","description":"Comma list, `-` prefix for descending; aliases accepted.","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Sparse field selection; aliases accepted.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"domainUnicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"discoveredVia":{"type":"string","enum":["serp","commoncrawl","outbound_links","manual_import","drop_list","marketplace","whois","user_watch","client_request","legacy-2023","sav_pending_delete","namecom_delete","majestic","semrush","gsc","web","sav","restored","checker","cc-index","other"]},"discoveredAt":{"type":"string","format":"date-time"},"keyword":{"type":["string","null"]},"seedSource":{"type":["string","null"]},"category":{"type":["string","null"],"enum":["free","expired","premium","active","new","aged","unknown",null]},"registrar":{"type":["string","null"]},"creationDate":{"type":["string","null"]},"expirationDate":{"type":["string","null"]},"nameServers":{"type":"array","items":{"type":"string"}},"lastCheckedAt":{"type":["string","null"]},"listing":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string"},"kind":{"type":"string","enum":["auction","backorder","closeout","buy_now"]},"endsAt":{"type":["string","null"]},"priceUsd":{"type":"number"},"bids":{"type":"integer"}},"required":["source","kind","endsAt","priceUsd","bids"]},{"type":"null"}]},"attentionUntil":{"type":["string","null"]},"priority":{"type":"integer"},"stages":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"stage":{"type":"string","enum":["lookup","get","whois","webarchive","google"]},"status":{"type":"string","enum":["ok","partial","failed","skipped"]},"stateHash":{"type":"string"},"validFrom":{"type":"string","format":"date-time"},"checkedAt":{"type":"string","format":"date-time"},"data":{"type":"object"},"error":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},{"type":"null"}]},"source":{"type":"string"}},"required":["stage","status","stateHash","validFrom","checkedAt","data","error","source"]}}},"required":["id","domain","domainUnicode","zone","name","discoveredVia","discoveredAt","category","nameServers","listing"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"discovery","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"discovery_registry_search"}},"/v1/registry/{domain}":{"get":{"operationId":"discovery.registry_get","tags":["service"],"summary":"Get a registry domain","description":"One registry domain with the latest result of every check stage.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"domainUnicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"discoveredVia":{"type":"string","enum":["serp","commoncrawl","outbound_links","manual_import","drop_list","marketplace","whois","user_watch","client_request","legacy-2023","sav_pending_delete","namecom_delete","majestic","semrush","gsc","web","sav","restored","checker","cc-index","other"]},"discoveredAt":{"type":"string","format":"date-time"},"keyword":{"type":["string","null"]},"seedSource":{"type":["string","null"]},"category":{"type":["string","null"],"enum":["free","expired","premium","active","new","aged","unknown",null]},"registrar":{"type":["string","null"]},"creationDate":{"type":["string","null"]},"expirationDate":{"type":["string","null"]},"nameServers":{"type":"array","items":{"type":"string"}},"lastCheckedAt":{"type":["string","null"]},"listing":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string"},"kind":{"type":"string","enum":["auction","backorder","closeout","buy_now"]},"endsAt":{"type":["string","null"]},"priceUsd":{"type":"number"},"bids":{"type":"integer"}},"required":["source","kind","endsAt","priceUsd","bids"]},{"type":"null"}]},"attentionUntil":{"type":["string","null"]},"priority":{"type":"integer"},"stages":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"stage":{"type":"string","enum":["lookup","get","whois","webarchive","google"]},"status":{"type":"string","enum":["ok","partial","failed","skipped"]},"stateHash":{"type":"string"},"validFrom":{"type":"string","format":"date-time"},"checkedAt":{"type":"string","format":"date-time"},"data":{"type":"object"},"error":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},{"type":"null"}]},"source":{"type":"string"}},"required":["stage","status","stateHash","validFrom","checkedAt","data","error","source"]}}},"required":["id","domain","domainUnicode","zone","name","discoveredVia","discoveredAt","category","nameServers","listing"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"discovery","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"discovery_registry_get"}},"/v1/registry/import":{"post":{"operationId":"discovery.registry_import","tags":["service"],"summary":"Import domains into the registry","description":"Bulk-imports domains (list or an uploaded CSV/TXT file id) into the registry; invalid lines are reported, duplicates skipped.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"domains":{"type":"array","items":{"type":"string","maxLength":300},"minItems":1,"maxItems":50000},"fileId":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"},"source":{"type":"string","enum":["serp","commoncrawl","outbound_links","manual_import","drop_list","marketplace"],"default":"manual_import"},"callbackUrl":{"type":"string","format":"uri","maxLength":2000},"clientRef":{"type":"string","minLength":1,"maxLength":200}}}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"discovery","x-safety":"job","x-tenancy":"workspace","x-mcp-tool":"discovery_registry_import"}},"/v1/discovery/stop-words":{"get":{"operationId":"discovery.stop_words_get","tags":["service"],"summary":"Get stop words","description":"Stop words and blocked content categories (adult, casino, pharma …) used when scoring domain history.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"words":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}}},"required":["words","categories"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"discovery","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"discovery_stop_words_get"},"put":{"operationId":"discovery.stop_words_set","tags":["service"],"summary":"Set stop words","description":"Replaces the stop-word list and blocked categories (workspace admins).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"words":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":5000,"uniqueItems":true},"categories":{"type":"array","items":{"type":"string","enum":["adult","casino","pharma","crypto","loans","dating","weapons","politics"]},"uniqueItems":true}},"required":["words","categories"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"words":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}}},"required":["words","categories"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"discovery","x-safety":"write","x-tenancy":"workspace","x-mcp-tool":"discovery_stop_words_set"}},"/v1/discovery/drops":{"get":{"operationId":"discovery.drop_calendar","tags":["service"],"summary":"Drop calendar","description":"Registry domains expected to drop per day (estimated from EPP status and expiry) in a date range, optionally by zone.","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"zone","in":"query","required":false,"schema":{"type":"string","maxLength":30}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"date":{"type":"string"},"count":{"type":"integer"},"domains":{"type":"array","items":{"type":"string"}}},"required":["date","count","domains"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"discovery","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"discovery_drop_calendar"}},"/v1/checks":{"post":{"operationId":"checks.start","tags":["service"],"summary":"Start a domain check","description":"Checks up to 5000 domains through the stages lookup (DNS) → get (HTTP) → whois (RDAP) → webarchive → google (index). Only changed states are stored as history.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"domains":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300},"minItems":1,"maxItems":5000},"stages":{"type":"array","items":{"type":"string","enum":["lookup","get","whois","webarchive","google"]},"minItems":1,"uniqueItems":true,"default":["lookup","get","whois","webarchive","google"]},"priority":{"type":"integer","minimum":0,"maximum":4,"default":4},"callbackUrl":{"type":"string","format":"uri","maxLength":2000},"clientRef":{"type":"string","minLength":1,"maxLength":200}},"required":["domains"]}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"checks","x-safety":"job","x-tenancy":"workspace","x-read-only-job":true,"x-mcp-tool":"checks_start"},"get":{"operationId":"checks.latest_list","tags":["service"],"summary":"Latest check state of registry domains","description":"Registry domains with the latest state of each stage (connect/noconnect, online/offline, whois/webarchive/google status), archive/index counts and days to drop.","parameters":[{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[<field>][<op>]=<value>; ops: eq, ne, gt, gte, lt, lte, in, nin, contains, prefix, between, isnull. Fields: `registryId` (string), `domain` (string), `zone` (string), `category` (string), `lastCheckedAt` (date), `expirationDate` (date), `archivePages` (integer; aliases: wb, wbPages, waybackPages), `indexedPages` (integer; aliases: gIndex, index), `daysToDrop` (integer), `online` (boolean), `lookup` (string).","schema":{"type":"object","additionalProperties":true}},{"name":"sort","in":"query","description":"Comma list, `-` prefix for descending; aliases accepted.","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Sparse field selection; aliases accepted.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"registryId":{"type":"string"},"domain":{"type":"string"},"domainUnicode":{"type":"string"},"zone":{"type":"string"},"category":{"type":["string","null"],"enum":["free","expired","premium","active","new","aged","unknown",null]},"registrar":{"type":["string","null"]},"expirationDate":{"type":["string","null"]},"lastCheckedAt":{"type":["string","null"]},"lookup":{"type":["string","null"]},"get":{"type":["string","null"]},"whois":{"type":["string","null"]},"webarchive":{"type":["string","null"]},"google":{"type":["string","null"]},"archivePages":{"type":["integer","null"]},"indexedPages":{"type":["integer","null"]},"online":{"type":["boolean","null"]},"daysToDrop":{"type":["integer","null"]}},"required":["registryId","domain","domainUnicode","zone","category","lookup","get","whois","webarchive","google"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"checks","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"checks_latest_list"}},"/v1/checks/{jobId}":{"get":{"operationId":"checks.result","tags":["service"],"summary":"Get check results","description":"Per-domain stage results of a finished check job, with the stages whose state changed in this run.","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"domainUnicode":{"type":"string"},"zone":{"type":["string","null"]},"category":{"type":["string","null"]},"stages":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"stage":{"type":"string","enum":["lookup","get","whois","webarchive","google"]},"status":{"type":"string","enum":["ok","partial","failed","skipped"]},"stateHash":{"type":"string"},"validFrom":{"type":"string","format":"date-time"},"checkedAt":{"type":"string","format":"date-time"},"data":{"type":"object"},"error":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},{"type":"null"}]},"source":{"type":"string"}},"required":["stage","status","stateHash","validFrom","checkedAt","data","error","source"]}},"changedStages":{"type":"array","items":{"type":"string","enum":["lookup","get","whois","webarchive","google"]}},"error":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},{"type":"null"}]}},"required":["domain","domainUnicode","zone","category","stages","changedStages","error"]}}},"required":["items"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"checks","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"checks_result"}},"/v1/domains/{domain}/checks/latest":{"get":{"operationId":"checks.latest","tags":["service"],"summary":"Latest check state of a domain","description":"Latest state of each check stage of one registry domain (connect/noconnect, online/offline, whois/webarchive/google status), archive/index counts and days to drop.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"registryId":{"type":"string"},"domain":{"type":"string"},"domainUnicode":{"type":"string"},"zone":{"type":"string"},"category":{"type":["string","null"],"enum":["free","expired","premium","active","new","aged","unknown",null]},"registrar":{"type":["string","null"]},"expirationDate":{"type":["string","null"]},"lastCheckedAt":{"type":["string","null"]},"lookup":{"type":["string","null"]},"get":{"type":["string","null"]},"whois":{"type":["string","null"]},"webarchive":{"type":["string","null"]},"google":{"type":["string","null"]},"archivePages":{"type":["integer","null"]},"indexedPages":{"type":["integer","null"]},"online":{"type":["boolean","null"]},"daysToDrop":{"type":["integer","null"]}},"required":["registryId","domain","domainUnicode","zone","category","lookup","get","whois","webarchive","google"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"checks","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"checks_latest"}},"/v1/domains/{domain}/checks/history":{"get":{"operationId":"checks.history","tags":["service"],"summary":"Check history of a domain","description":"Change-only history of stage states (one entry per state change; unchanged re-checks only advance lastCheckedAt).","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}},{"name":"stage","in":"query","required":false,"schema":{"type":"string","enum":["lookup","get","whois","webarchive","google"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"history":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"stage":{"type":"string","enum":["lookup","get","whois","webarchive","google"]},"status":{"type":"string","enum":["ok","partial","failed","skipped"]},"stateHash":{"type":"string"},"validFrom":{"type":"string","format":"date-time"},"checkedAt":{"type":"string","format":"date-time"},"data":{"type":"object"},"error":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},{"type":"null"}]},"source":{"type":"string"}},"required":["stage","status","stateHash","validFrom","checkedAt","data","error","source"]}},"lastChecks":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"stage":{"type":"string","enum":["lookup","get","whois","webarchive","google"]},"lastCheckedAt":{"type":["string","null"]},"checksCount":{"type":"integer"}},"required":["stage","lastCheckedAt","checksCount"]}}},"required":["domain","history","lastChecks"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"checks","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"checks_history"}},"/v1/domains/{domain}/availability":{"get":{"operationId":"checks.availability","tags":["service"],"summary":"Check availability","description":"Registrability of a domain from stored registry / RDAP / DNS facts, with the price of a fresh offer. Preliminary: stored data at once (asOf, freshness; no live RDAP); a status older than 24 h queues a refresh, handle in meta.refresh (refresh_wait).","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"available":{"type":"boolean"},"premium":{"type":"boolean"},"priceUsd":{"type":["number","null"]},"phase":{"type":"string"},"source":{"type":"string"},"status":{"type":"string","description":"Domain status by the freshness rule (available only with the double confirmation; unknown stays unknown)"},"asOf":{"type":["string","null"],"format":"date-time","description":"When the stored fact behind the answer was observed (null: never)"},"freshness":{"type":"string","enum":["fresh","aging","stale"],"description":"fresh ≤ 24 h, aging ≤ 7 d, stale older / never"},"refreshing":{"type":"boolean","description":"A refresh is queued / running; poll refreshGet with meta.refresh.id"}},"required":["domain","available","premium","priceUsd","phase","source"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"checks","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"checks_availability"}},"/v1/domains/{domain}/whois":{"get":{"operationId":"checks.whois","tags":["service"],"summary":"WHOIS / RDAP","description":"Normalized registration data: registrar, creation/expiry dates, EPP statuses, name servers (newest stored whois; status unknown = nothing stored). Preliminary: stored data at once (asOf, freshness; no live RDAP); a status older than 24 h queues a refresh, handle in meta.refresh (refresh_wait).","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"registered":{"type":"boolean"},"registrar":{"type":["string","null"]},"creationDate":{"type":["string","null"]},"expirationDate":{"type":["string","null"]},"eppStatuses":{"type":"array","items":{"type":"string"}},"nameServers":{"type":"array","items":{"type":"string"}},"category":{"type":"string"},"source":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"status":{"type":"string","description":"Domain status by the freshness rule (available only with the double confirmation; unknown stays unknown)"},"asOf":{"type":["string","null"],"format":"date-time","description":"When the stored fact behind the answer was observed (null: never)"},"freshness":{"type":"string","enum":["fresh","aging","stale"],"description":"fresh ≤ 24 h, aging ≤ 7 d, stale older / never"},"refreshing":{"type":"boolean","description":"A refresh is queued / running; poll refreshGet with meta.refresh.id"}},"required":["domain","registered","eppStatuses","nameServers","category","source","observedAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"checks","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"checks_whois"}},"/v1/domains/{domain}/dns":{"get":{"operationId":"checks.dns","tags":["service"],"summary":"DNS records","description":"A/AAAA/NS/MX/TXT records of a domain.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}},{"name":"types","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["A","AAAA","NS","MX","TXT","CNAME","SOA"]},"default":["A","NS","MX","TXT"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"resolves":{"type":"boolean"},"records":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string"},"value":{"type":"string"}},"required":["type","value"]}},"source":{"type":"string"}},"required":["domain","resolves","records","source"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"checks","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"checks_dns"}},"/v1/domains/{domain}/ssl":{"get":{"operationId":"checks.ssl","tags":["service"],"summary":"SSL certificate","description":"TLS certificate issuer, validity window and SANs of a domain (null when no HTTPS).","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"present":{"type":"boolean"},"issuer":{"type":["string","null"]},"validFrom":{"type":["string","null"]},"validTo":{"type":["string","null"]},"daysLeft":{"type":["integer","null"]},"san":{"type":"array","items":{"type":"string"}}},"required":["domain","present","san"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"checks","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"checks_ssl"}},"/v1/domains/{domain}/drop-estimate":{"get":{"operationId":"checks.drop_estimate","tags":["service"],"summary":"Estimate drop date","description":"Lifecycle phase (active / grace / redemption / pending delete / available), estimated drop date and confidence. Preliminary: stored data at once (asOf, freshness; no live RDAP); a status older than 24 h queues a refresh, handle in meta.refresh (refresh_wait).","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"phase":{"type":"string"},"eppStatuses":{"type":"array","items":{"type":"string"}},"expirationDate":{"type":["string","null"]},"estimatedDropDate":{"type":["string","null"]},"daysToDrop":{"type":["integer","null"]},"confidence":{"type":"string","enum":["high","medium","low"]},"status":{"type":"string","description":"Domain status by the freshness rule (available only with the double confirmation; unknown stays unknown)"},"asOf":{"type":["string","null"],"format":"date-time","description":"When the stored fact behind the answer was observed (null: never)"},"freshness":{"type":"string","enum":["fresh","aging","stale"],"description":"fresh ≤ 24 h, aging ≤ 7 d, stale older / never"},"refreshing":{"type":"boolean","description":"A refresh is queued / running; poll refreshGet with meta.refresh.id"}},"required":["domain","phase","eppStatuses","confidence"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"checks","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"checks_drop_estimate"}},"/v1/checks/attention":{"post":{"operationId":"checks.attention_request","tags":["service"],"summary":"Request check attention","description":"Raises check priority for domains an operator is working on or an AI recommended (bumps them in the check schedule until `until`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"domains":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300},"minItems":1,"maxItems":1000},"source":{"type":"string","enum":["operator_work","operator_view","ai_recommendation"]},"until":{"type":"string","format":"date-time"}},"required":["domains","source"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"updated":{"type":"integer"},"until":{"type":"string"}},"required":["updated","until"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"checks","x-safety":"write","x-tenancy":"workspace","x-mcp-tool":"checks_attention_request"}},"/v1/domains/{domain}/metrics":{"get":{"operationId":"metrics.get","tags":["service"],"summary":"Domain intelligence","description":"Metrics (authority/dr, trust/tf, citation/cf, refDomains/rd, backlinks, spamScore, traffic, age, archive and index pages) with source and observedAt, backlink summary, anchors, topics, spam/penalty signals, ownership and content history. Market data is cached.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}},{"name":"metrics","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","x-metric-name":true,"enum":["authority","trust","citation","refDomains","backlinks","spamScore","traffic","ageYears","archivePages","indexedPages"]},"uniqueItems":true}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"domainUnicode":{"type":"string"},"metrics":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","enum":["authority","trust","citation","refDomains","backlinks","spamScore","traffic","ageYears","archivePages","indexedPages"]},"value":{"type":["number","null"]},"source":{"type":["string","null"]},"observedAt":{"type":["string","null"]},"cached":{"type":"boolean"}},"required":["name","value","source","observedAt"]}},"backlinkSummary":{"type":"object","additionalProperties":false,"properties":{"backlinks":{"type":"integer"},"refDomains":{"type":"integer"},"dofollowPct":{"type":"number"},"newLast30":{"type":"integer"},"lostLast30":{"type":"integer"},"eduGov":{"type":"integer"}},"required":["backlinks","refDomains","dofollowPct","newLast30","lostLast30","eduGov"]},"anchors":{"type":"array","items":{"type":"object"}},"topics":{"type":"array","items":{"type":"object"}},"spamSignals":{"type":"array","items":{"type":"object"}},"penaltySignals":{"type":"array","items":{"type":"object"}},"ownershipHistory":{"type":"array","items":{"type":"object"}},"contentHistory":{"type":"array","items":{"type":"object"}},"historyState":{"type":"string","enum":["clean","topic_change","spam"]},"sources":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"observedAt":{"type":["string","null"]}},"required":["name","observedAt"]}},"providerMetrics":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"value":{"type":["number","null"]},"source":{"type":"string"},"observedAt":{"type":["string","null"]}},"required":["name","value","source","observedAt"]}}},"required":["domain","metrics","backlinkSummary","anchors","topics","spamSignals","penaltySignals","ownershipHistory","contentHistory","historyState","sources"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"metrics","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"metrics_get"}},"/v1/domains/{domain}/metrics/history":{"get":{"operationId":"metrics.history","tags":["service"],"summary":"Metric history","description":"Monthly series of selected metrics (aliases accepted) and of raw provider metrics by id (e.g. a provider rank); every stored observation month is returned.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}},{"name":"names","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","x-metric-name":true,"enum":["authority","trust","citation","refDomains","backlinks","spamScore","traffic","ageYears","archivePages","indexedPages"]},"minItems":1,"uniqueItems":true,"default":["trust","authority","refDomains"]}},{"name":"providerMetrics","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,40}$"},"maxItems":10,"uniqueItems":true}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"points":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"at":{"type":"string"},"value":{"type":"number"},"source":{"type":"string"}},"required":["at","value"]}}},"required":["name","points"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"metrics","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"metrics_history"}},"/v1/domains/{domain}/backlinks":{"get":{"operationId":"backlinks.list","tags":["service"],"summary":"Backlinks of a domain","description":"Paged backlink rows (source URL/domain, target, anchor, rel, first/last seen, lost, source authority, source) from the stored backlink data and the link index (links from other domains), in cursor pages.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[<field>][<op>]=<value>; ops: eq, ne, gt, gte, lt, lte, in, nin, contains, prefix, between, isnull. Fields: `sourceDomain` (string), `anchor` (string), `rel` (string), `firstSeen` (date), `lastSeen` (date), `lost` (boolean), `sourceAuthority` (integer), `source` (string).","schema":{"type":"object","additionalProperties":true}},{"name":"sort","in":"query","description":"Comma list, `-` prefix for descending; aliases accepted.","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Sparse field selection; aliases accepted.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"metrics","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"backlinks_list"}},"/v1/domains/{domain}/ref-domains":{"get":{"operationId":"backlinks.refdomains","tags":["service"],"summary":"Referring domains","description":"Paged referring domains with link counts, authority, first / last seen, lost flags and sources.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[<field>][<op>]=<value>; ops: eq, ne, gt, gte, lt, lte, in, nin, contains, prefix, between, isnull. Fields: `domain` (string), `backlinks` (integer; aliases: bl, links), `authority` (integer; aliases: dr, da, as), `firstSeen` (date), `lastSeen` (date), `lost` (boolean).","schema":{"type":"object","additionalProperties":true}},{"name":"sort","in":"query","description":"Comma list, `-` prefix for descending; aliases accepted.","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Sparse field selection; aliases accepted.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"backlinks":{"type":"integer"},"authority":{"type":["integer","null"]},"firstSeen":{"type":["string","null"]},"lastSeen":{"type":["string","null"]},"lost":{"type":"boolean"},"sources":{"type":"array","items":{"type":"string"}}},"required":["id","domain","backlinks","authority","firstSeen","lost"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"metrics","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"backlinks_refdomains"}},"/v1/domains/{domain}/anchors":{"get":{"operationId":"backlinks.anchors","tags":["service"],"summary":"Anchor distribution","description":"Anchor texts with counts, share and type (brand, url, exact, partial, generic).","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"anchor":{"type":"string"},"type":{"type":"string"},"count":{"type":"integer"},"pct":{"type":"number"}},"required":["anchor","type","count","pct"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"metrics","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"backlinks_anchors"}},"/v1/domains/{domain}/topics":{"get":{"operationId":"metrics.topics","tags":["service"],"summary":"Topical categories","description":"Topical categories of a domain with weights (the share of archive periods per topic of the topic timeline, else the current topic).","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"topic":{"type":"string"},"weight":{"type":"number"}},"required":["topic","weight"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"metrics","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"metrics_topics"}},"/v1/domains/{domain}/history":{"get":{"operationId":"metrics.domain_history","tags":["service"],"summary":"Ownership and content history","description":"Registration/transfer/expiry/drop/auction events and archived content by year with topic drift and adult/casino/pharma flags.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"historyState":{"type":"string"},"ownership":{"type":"array","items":{"type":"object"}},"content":{"type":"array","items":{"type":"object"}},"penaltySignals":{"type":"array","items":{"type":"object"}}},"required":["domain","historyState","ownership","content","penaltySignals"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"metrics","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"metrics_domain_history"}},"/v1/metrics/compare":{"post":{"operationId":"metrics.compare","tags":["service"],"summary":"Compare domains","description":"Side-by-side metrics (aliases accepted) for 2–20 domains from the stored observations (metrics.enrich refreshes them).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"domains":{"type":"array","items":{"type":"string","minLength":3,"maxLength":300},"minItems":2,"maxItems":20,"uniqueItems":true},"metrics":{"type":"array","items":{"type":"string","x-metric-name":true,"enum":["authority","trust","citation","refDomains","backlinks","spamScore","traffic","ageYears","archivePages","indexedPages"]},"minItems":1,"uniqueItems":true,"default":["trust","citation","authority","refDomains","spamScore","ageYears"]}},"required":["domains"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"metrics":{"type":"object","additionalProperties":{"type":["number","null"]}}},"required":["domain","metrics"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"metrics","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"metrics_compare"}},"/v1/metrics/enrich":{"post":{"operationId":"metrics.enrich","tags":["service"],"summary":"Enrich domain metrics","description":"Refreshes the provider metrics of up to 1000 domains from paid data sources (within the connection budgets; stops once maxCostUsd is spent) and stores them (source = the data source id). 402 when the estimate exceeds maxCostUsd; 503 NOT_CONFIGURED without a data source for the requested metrics. Metrics that are not provider metrics are reported as skipped.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"domains":{"type":"array","items":{"type":"string","minLength":3,"maxLength":300},"minItems":1,"maxItems":1000},"metrics":{"type":"array","items":{"type":"string","x-metric-name":true,"enum":["authority","trust","citation","refDomains","backlinks","spamScore","traffic","ageYears","archivePages","indexedPages"]},"minItems":1,"uniqueItems":true,"default":["authority","trust","citation","refDomains","backlinks","spamScore","traffic","ageYears","archivePages","indexedPages"]},"fresh":{"type":"boolean","default":false},"maxCostUsd":{"type":"number","minimum":0,"default":5},"backlinks":{"type":"integer","minimum":0,"maximum":1000,"default":0,"description":"Also fetch up to this many provider backlinks per domain (0 = none)."},"callbackUrl":{"type":"string","format":"uri","maxLength":2000},"clientRef":{"type":"string","minLength":1,"maxLength":200}},"required":["domains"]}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"metrics","x-safety":"job","x-tenancy":"workspace","x-read-only-job":true,"x-mcp-tool":"metrics_enrich"}},"/v1/snapshots/window":{"get":{"operationId":"snapshots.window","tags":["service"],"summary":"Pre-expiry window","description":"Registry domains within fromDays…toDays of expiry (default −30…0) that still resolve, with their snapshot state — capture them before content disappears.","parameters":[{"name":"fromDays","in":"query","required":false,"schema":{"type":"integer","minimum":-365,"maximum":0,"default":-30}},{"name":"toDays","in":"query","required":false,"schema":{"type":"integer","minimum":-365,"maximum":30,"default":0}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"domainUnicode":{"type":"string"},"daysToExpiry":{"type":"integer"},"resolves":{"type":"boolean"},"online":{"type":"boolean"},"snapshot":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"domainUnicode":{"type":"string"},"state":{"type":"string","enum":["not_taken","scheduled","taking","taken","failed"]},"filesCount":{"type":["integer","null"]},"sizeBytes":{"type":["integer","null"]},"httpStatus":{"type":["integer","null"]},"depth":{"type":"integer"},"jobId":{"type":["string","null"]},"takenAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","domain","state"]},{"type":"null"}]}},"required":["domain","daysToExpiry","resolves","online","snapshot"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"snapshots","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"snapshots_window"}},"/v1/snapshots":{"post":{"operationId":"snapshots.take","tags":["service"],"summary":"Take snapshots","description":"Captures a full wget-style snapshot of still-online domains (depth, file cap) and stores the file list.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"domains":{"type":"array","items":{"type":"string","minLength":3,"maxLength":300},"minItems":1,"maxItems":100,"uniqueItems":true},"depth":{"type":"integer","minimum":1,"maximum":10,"default":5},"maxFiles":{"type":"integer","minimum":10,"maximum":50000,"default":5000},"callbackUrl":{"type":"string","format":"uri","maxLength":2000},"clientRef":{"type":"string","minLength":1,"maxLength":200}},"required":["domains"]}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"snapshots","x-safety":"job","x-tenancy":"workspace","x-read-only-job":true,"x-mcp-tool":"snapshots_take"},"get":{"operationId":"snapshots.list","tags":["service"],"summary":"List snapshots","description":"Snapshots with state, file count and size.","parameters":[{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[<field>][<op>]=<value>; ops: eq, ne, gt, gte, lt, lte, in, nin, contains, prefix, between, isnull. Fields: `domain` (string), `state` (string), `takenAt` (date), `createdAt` (date), `filesCount` (integer).","schema":{"type":"object","additionalProperties":true}},{"name":"sort","in":"query","description":"Comma list, `-` prefix for descending; aliases accepted.","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Sparse field selection; aliases accepted.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"domainUnicode":{"type":"string"},"state":{"type":"string","enum":["not_taken","scheduled","taking","taken","failed"]},"filesCount":{"type":["integer","null"]},"sizeBytes":{"type":["integer","null"]},"httpStatus":{"type":["integer","null"]},"depth":{"type":"integer"},"jobId":{"type":["string","null"]},"takenAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","domain","state"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"snapshots","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"snapshots_list"}},"/v1/snapshots/{id}":{"get":{"operationId":"snapshots.get","tags":["service"],"summary":"Get a snapshot","description":"Snapshot state, files count, size and HTTP status.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"domainUnicode":{"type":"string"},"state":{"type":"string","enum":["not_taken","scheduled","taking","taken","failed"]},"filesCount":{"type":["integer","null"]},"sizeBytes":{"type":["integer","null"]},"httpStatus":{"type":["integer","null"]},"depth":{"type":"integer"},"jobId":{"type":["string","null"]},"takenAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","domain","state"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"snapshots","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"snapshots_get"},"delete":{"operationId":"snapshots.delete","tags":["service"],"summary":"Delete a snapshot","description":"Deletes a snapshot and its stored files.\n\nRequires `confirm: true`; without it the API answers 428 with a dry-run preview.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"confirm","in":"query","required":false,"schema":{"type":"boolean","description":"Must be true to execute; otherwise 428 with a dry-run preview."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"domainUnicode":{"type":"string"},"state":{"type":"string","enum":["not_taken","scheduled","taking","taken","failed"]},"filesCount":{"type":["integer","null"]},"sizeBytes":{"type":["integer","null"]},"httpStatus":{"type":["integer","null"]},"depth":{"type":"integer"},"jobId":{"type":["string","null"]},"takenAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","domain","state"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"428":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"snapshots","x-safety":"destructive","x-tenancy":"workspace","x-mcp-tool":"snapshots_delete"}},"/v1/snapshots/{id}/files":{"get":{"operationId":"snapshots.files","tags":["service"],"summary":"Snapshot files","description":"Paged file list of a snapshot (path, MIME type, size, HTTP status).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[<field>][<op>]=<value>; ops: eq, ne, gt, gte, lt, lte, in, nin, contains, prefix, between, isnull. Fields: `path` (string), `mime` (string), `size` (integer).","schema":{"type":"object","additionalProperties":true}},{"name":"sort","in":"query","description":"Comma list, `-` prefix for descending; aliases accepted.","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Sparse field selection; aliases accepted.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"path":{"type":"string"},"mime":{"type":"string"},"size":{"type":"integer"},"status":{"type":"integer"}},"required":["id","path","mime","size","status"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"snapshots","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"snapshots_files"}},"/v1/domains/{domain}/archive/timeline":{"get":{"operationId":"archive.timeline","tags":["service"],"summary":"Archive timeline","description":"Captures by year from the web archive or the crawl archive, with the first / last capture.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}},{"name":"source","in":"query","required":false,"schema":{"type":"string","enum":["webarchive","commoncrawl"],"default":"webarchive"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"source":{"type":"string"},"captures":{"type":"integer"},"firstCapture":{"type":["string","null"]},"lastCapture":{"type":["string","null"]},"byYear":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"year":{"type":"integer"},"captures":{"type":"integer"}},"required":["year","captures"]}}},"required":["domain","source","captures","byYear"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"archive","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"archive_timeline"}},"/v1/archive/jobs":{"post":{"operationId":"archive.job_start","tags":["service"],"summary":"Start archive restore","description":"Runs download → parse → compare → classify (pages/posts) → export (WordPress CSV) for a domain from the web archive or the crawl archive.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string","minLength":3,"maxLength":300},"source":{"type":"string","enum":["webarchive","commoncrawl"],"default":"webarchive"},"collection":{"type":"string","pattern":"^CC-MAIN-\\d{4}-\\d{2}$"},"stages":{"type":"array","items":{"type":"string","enum":["download","parse","compare","classify","export"]},"minItems":1,"uniqueItems":true,"default":["download","parse","compare","classify","export"]},"callbackUrl":{"type":"string","format":"uri","maxLength":2000},"clientRef":{"type":"string","minLength":1,"maxLength":200}},"required":["domain"]}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"archiveJob":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"domainUnicode":{"type":"string"},"source":{"type":"string","enum":["webarchive","commoncrawl"]},"collection":{"type":["string","null"]},"stages":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"stage":{"type":"string","enum":["download","parse","compare","classify","export"]},"status":{"type":"string"},"startedAt":{"type":["string","null"]},"finishedAt":{"type":["string","null"]}},"required":["stage","status"]}},"totals":{"type":"object"},"running":{"type":"boolean"},"jobId":{"type":["string","null"]},"exportFileId":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","domain","source","stages","totals","running"]},"job":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]}},"required":["archiveJob","job"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"archive","x-safety":"job","x-tenancy":"workspace","x-mcp-tool":"archive_job_start"},"get":{"operationId":"archive.jobs_list","tags":["service"],"summary":"List archive jobs","description":"Archive restore jobs with per-stage status and totals (the pipeline screen).","parameters":[{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[<field>][<op>]=<value>; ops: eq, ne, gt, gte, lt, lte, in, nin, contains, prefix, between, isnull. Fields: `domain` (string), `source` (string), `running` (boolean), `createdAt` (date), `updatedAt` (date).","schema":{"type":"object","additionalProperties":true}},{"name":"sort","in":"query","description":"Comma list, `-` prefix for descending; aliases accepted.","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Sparse field selection; aliases accepted.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"domainUnicode":{"type":"string"},"source":{"type":"string","enum":["webarchive","commoncrawl"]},"collection":{"type":["string","null"]},"stages":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"stage":{"type":"string","enum":["download","parse","compare","classify","export"]},"status":{"type":"string"},"startedAt":{"type":["string","null"]},"finishedAt":{"type":["string","null"]}},"required":["stage","status"]}},"totals":{"type":"object"},"running":{"type":"boolean"},"jobId":{"type":["string","null"]},"exportFileId":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","domain","source","stages","totals","running"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"archive","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"archive_jobs_list"}},"/v1/archive/jobs/{id}":{"get":{"operationId":"archive.job_get","tags":["service"],"summary":"Get archive job","description":"One archive restore job with stages and totals.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"domainUnicode":{"type":"string"},"source":{"type":"string","enum":["webarchive","commoncrawl"]},"collection":{"type":["string","null"]},"stages":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"stage":{"type":"string","enum":["download","parse","compare","classify","export"]},"status":{"type":"string"},"startedAt":{"type":["string","null"]},"finishedAt":{"type":["string","null"]}},"required":["stage","status"]}},"totals":{"type":"object"},"running":{"type":"boolean"},"jobId":{"type":["string","null"]},"exportFileId":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","domain","source","stages","totals","running"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"archive","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"archive_job_get"}},"/v1/archive/jobs/{id}/files":{"get":{"operationId":"archive.files","tags":["service"],"summary":"Archive files","description":"Files of an archive job with type, classification (page/post/asset/skip) and uniqueness.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[<field>][<op>]=<value>; ops: eq, ne, gt, gte, lt, lte, in, nin, contains, prefix, between, isnull. Fields: `origPath` (string), `fileType` (string), `classification` (string), `unique` (boolean), `words` (integer).","schema":{"type":"object","additionalProperties":true}},{"name":"sort","in":"query","description":"Comma list, `-` prefix for descending; aliases accepted.","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Sparse field selection; aliases accepted.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"origPath":{"type":"string"},"slug":{"type":"string"},"wbTimestamp":{"type":["string","null"]},"fileType":{"type":"string"},"classification":{"type":"string","enum":["page","post","asset","skip"]},"unique":{"type":"boolean"},"title":{"type":["string","null"]},"words":{"type":"integer"},"source":{"type":"string"}},"required":["id","origPath","slug","fileType","classification","unique"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"archive","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"archive_files"},"patch":{"operationId":"archive.classify","tags":["service"],"summary":"Reclassify archive files","description":"Moves files between pages, posts, assets and skip before export.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"changes":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"fileId":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"},"classification":{"type":"string","enum":["page","post","asset","skip"]}},"required":["fileId","classification"]},"minItems":1,"maxItems":5000}},"required":["changes"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"updated":{"type":"integer"},"totals":{"type":"object"}},"required":["updated","totals"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"archive","x-safety":"write","x-tenancy":"workspace","x-mcp-tool":"archive_classify"}},"/v1/domains/{domain}/archive/coverage":{"get":{"operationId":"archive.coverage","tags":["service"],"summary":"Archive coverage","description":"Which restored paths exist only in the web archive, only in the crawl archive, or in both.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"onlyWebarchive":{"type":"integer"},"onlyCommoncrawl":{"type":"integer"},"both":{"type":"integer"}},"required":["domain","onlyWebarchive","onlyCommoncrawl","both"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"archive","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"archive_coverage"}},"/v1/archive/jobs/{id}/export":{"post":{"operationId":"archive.export","tags":["service"],"summary":"Export for WordPress","description":"Exports classified pages and posts as WordPress CSV or WXR; the result references a downloadable file.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"format":{"type":"string","enum":["wp_csv","wxr"],"default":"wp_csv"},"callbackUrl":{"type":"string","format":"uri","maxLength":2000},"clientRef":{"type":"string","minLength":1,"maxLength":200}}}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"archive","x-safety":"job","x-tenancy":"workspace","x-mcp-tool":"archive_export"}},"/v1/links":{"get":{"operationId":"links.list","tags":["service"],"summary":"Link table","description":"Links seen by the crawler: incoming (direction=in) or outgoing (out) for a domain, with anchor, context and first/last seen.","parameters":[{"name":"domain","in":"query","required":false,"schema":{"type":"string","minLength":3,"maxLength":300}},{"name":"direction","in":"query","required":false,"schema":{"type":"string","enum":["in","out"],"default":"in"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[<field>][<op>]=<value>; ops: eq, ne, gt, gte, lt, lte, in, nin, contains, prefix, between, isnull. Fields: `fromDomain` (string), `toDomain` (string), `anchor` (string), `lost` (boolean), `firstSeen` (date), `lastSeen` (date).","schema":{"type":"object","additionalProperties":true}},{"name":"sort","in":"query","description":"Comma list, `-` prefix for descending; aliases accepted.","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Sparse field selection; aliases accepted.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"fromUrl":{"type":"string"},"toUrl":{"type":"string"},"fromDomain":{"type":"string"},"toDomain":{"type":"string"},"anchor":{"type":"string"},"beforeText":{"type":"string"},"afterText":{"type":"string"},"firstSeen":{"type":"string"},"lastSeen":{"type":"string"},"lost":{"type":"boolean"},"blinked":{"type":"integer"},"source":{"type":"string"}},"required":["id","fromUrl","toUrl","fromDomain","toDomain","anchor","firstSeen","lastSeen","lost"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"crawl","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"links_list"}},"/v1/links/changes":{"get":{"operationId":"links.changes","tags":["service"],"summary":"Gained / lost links","description":"Links gained (first seen) or lost (not seen for 7+ days) within a period.","parameters":[{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["gained","lost"],"default":"lost"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"domain","in":"query","required":false,"schema":{"type":"string","maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"fromUrl":{"type":"string"},"toUrl":{"type":"string"},"fromDomain":{"type":"string"},"toDomain":{"type":"string"},"anchor":{"type":"string"},"beforeText":{"type":"string"},"afterText":{"type":"string"},"firstSeen":{"type":"string"},"lastSeen":{"type":"string"},"lost":{"type":"boolean"},"blinked":{"type":"integer"},"source":{"type":"string"}},"required":["id","fromUrl","toUrl","fromDomain","toDomain","anchor","firstSeen","lastSeen","lost"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"crawl","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"links_changes"}},"/v1/crawl/status":{"get":{"operationId":"crawl.status","tags":["service"],"summary":"Crawler status","description":"Crawler state: running, pages/min, queue, links and errors today, log tail.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"running":{"type":"boolean"},"pagesPerMinute":{"type":"integer"},"queueSize":{"type":"integer"},"linksToday":{"type":"integer"},"errorsToday":{"type":"integer"},"log":{"type":"array","items":{"type":"string"}}},"required":["running","pagesPerMinute","queueSize","linksToday","errorsToday","log"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"crawl","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"crawl_status"}},"/v1/crawl/runs":{"post":{"operationId":"crawl.start","tags":["service"],"summary":"Start a crawl","description":"Crawls seed domains/pages to depth N (≤ maxPages) and records outgoing links.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"seeds":{"type":"array","items":{"type":"string","minLength":3,"maxLength":1000},"minItems":1,"maxItems":100},"depth":{"type":"integer","minimum":1,"maximum":5,"default":2},"maxPages":{"type":"integer","minimum":1,"maximum":100000,"default":500},"callbackUrl":{"type":"string","format":"uri","maxLength":2000},"clientRef":{"type":"string","minLength":1,"maxLength":200}},"required":["seeds"]}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"crawl","x-safety":"job","x-tenancy":"workspace","x-read-only-job":true,"x-mcp-tool":"crawl_start"},"get":{"operationId":"crawl.runs","tags":["service"],"summary":"List crawl runs","description":"Crawl runs of the caller (crawl.site jobs, newest first): seeds, depth, page budget, status, progress and stats (pages, external links, new / lost links, errors) from the result or, for an interrupted run, its saved state. Queued / running runs show progress only.","parameters":[{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[<field>][<op>]=<value>; ops: eq, ne, gt, gte, lt, lte, in, nin, contains, prefix, between, isnull. Fields: `status` (string), `createdAt` (date), `completedAt` (date), `pages` (number), `links` (number).","schema":{"type":"object","additionalProperties":true}},{"name":"sort","in":"query","description":"Comma list, `-` prefix for descending; aliases accepted.","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Sparse field selection; aliases accepted.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"jobId":{"type":"string"},"status":{"type":"string"},"seeds":{"type":"array","items":{"type":"string"}},"depth":{"type":["integer","null"]},"maxPages":{"type":["integer","null"]},"pages":{"type":["integer","null"]},"links":{"type":["integer","null"]},"newLinks":{"type":["integer","null"]},"lostLinks":{"type":["integer","null"]},"errors":{"type":["integer","null"]},"progressPct":{"type":"integer"},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","jobId","status","seeds","progressPct","createdAt"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"crawl","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"crawl_runs"}},"/v1/links/velocity":{"get":{"operationId":"links.velocity","tags":["service"],"summary":"Link velocity","description":"Links gained and lost per week (or month) for a target domain.","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}},{"name":"period","in":"query","required":false,"schema":{"type":"string","enum":["week","month"],"default":"week"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"period":{"type":"string"},"gained":{"type":"integer"},"lost":{"type":"integer"}},"required":["period","gained","lost"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"crawl","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"links_velocity"}},"/v1/serp/query":{"post":{"operationId":"serp.query","tags":["service"],"summary":"SERP query","description":"Search results of a keyword: the stored result page when younger than maxAgeDays (default 7), else a live, metered search that is stored. Live pages count against the daily search quota (429 + Retry-After). 503 NOT_CONFIGURED when live search is not available.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string","minLength":1,"maxLength":500},"engine":{"type":"string","enum":["google","yandex","bing"],"default":"google"},"gl":{"type":"string","minLength":2,"maxLength":2,"description":"Country code (default us)"},"hl":{"type":"string","minLength":2,"maxLength":10,"description":"Interface language"},"depth":{"type":"integer","minimum":10,"maximum":100,"default":10},"maxAgeDays":{"type":"integer","minimum":0,"maximum":365,"description":"Accept a cached result up to this age (0 = always live)"},"volume":{"type":"integer","minimum":0,"description":"Search volume of the keyword, stored with a live SERP"},"cpc":{"type":"number","minimum":0,"description":"CPC of the keyword, stored with a live SERP"},"clientRef":{"type":"string","maxLength":200}},"required":["keyword"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string"},"engine":{"type":"string"},"gl":{"type":"string"},"depth":{"type":"integer"},"cached":{"type":"boolean"},"source":{"type":"string"},"queriedAt":{"type":"string","format":"date-time"},"totalResults":{"type":["integer","null"]},"results":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"position":{"type":"integer"},"url":{"type":"string"},"domain":{"type":["string","null"]},"title":{"type":"string"},"snippet":{"type":"string"}},"required":["position","url","domain","title","snippet"]}}},"required":["keyword","engine","gl","depth","cached","source","queriedAt","totalResults","results"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"serp","x-safety":"job","x-tenancy":"workspace","x-read-only-job":true,"x-mcp-tool":"serp_query"}},"/v1/domains/{domain}/index-count":{"get":{"operationId":"serp.index_count","tags":["service"],"summary":"Indexed pages of a domain","description":"Pages of the domain in the search index (a site: query); the stored count when younger than maxAgeDays (default 7). Live queries count against the daily search quota. 503 NOT_CONFIGURED when live search is not available.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}},{"name":"engine","in":"query","required":false,"schema":{"type":"string","enum":["google","yandex"],"default":"google"}},{"name":"maxAgeDays","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":365}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"engine":{"type":"string"},"indexedPages":{"type":"integer"},"sampleTitle":{"type":["string","null"]},"cached":{"type":"boolean"},"source":{"type":"string"},"checkedAt":{"type":"string","format":"date-time"}},"required":["domain","engine","indexedPages","sampleTitle","cached","source","checkedAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"serp","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"serp_index_count"}},"/v1/domains/{domain}/archive/stats":{"get":{"operationId":"archive.stats","tags":["service"],"summary":"Archive statistics of a domain","description":"Web archive metrics of a domain (from the archive index): captures, unique URLs, first / last capture, captures and unique pages per year, status / mime mix and home page content changes, with the observation time (asOf) and source. Refreshed regularly (every 30 days for watched and actively tracked domains) or on demand with archive.enrich.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"domainUnicode":{"type":"string"},"asOf":{"type":["string","null"],"description":"When the counters were observed (null: never)."},"source":{"type":["string","null"],"description":"Where the counters come from: a live archive index read, or the historical baseline."},"stale":{"type":"boolean","description":"Older than the refresh period (30 days by default) or never observed."},"captures":{"type":["integer","null"]},"uniqueUrls":{"type":["integer","null"]},"firstCapture":{"type":["string","null"]},"lastCapture":{"type":["string","null"]},"perYear":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"year":{"type":"integer"},"captures":{"type":"integer"},"uniqueUrls":{"type":"integer"}},"required":["year","captures","uniqueUrls"]}},"homeChanges":{"type":["integer","null"],"description":"Content changes of the home page (digest changes)."},"homeChangeTs":{"type":"array","items":{"type":"string"}},"statusMix":{"type":"object","additionalProperties":{"type":"integer"}},"mimeMix":{"type":"object","additionalProperties":{"type":"integer"}},"truncated":{"type":"boolean"},"adsTxt":{"type":"object","additionalProperties":false,"properties":{"present":{"type":["boolean","null"]},"sellers":{"type":"integer"},"direct":{"type":"integer"},"reseller":{"type":"integer"},"systems":{"type":"array","items":{"type":"string"}},"source":{"type":["string","null"]},"asOf":{"type":["string","null"]}},"required":["present","sellers"],"description":"ads.txt presence: sellers seen in the live or archived ads.txt (present null: never looked)."}},"required":["domain","asOf","stale","captures","perYear"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"archive","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"archive_stats"}},"/v1/domains/{domain}/archive/topics":{"get":{"operationId":"archive.topic_timeline","tags":["service"],"summary":"Topic timeline of a domain","description":"What lived on the domain over the years: per period (calendar year of the enriched home page captures) the topic, language, CMS, analytics / ad publisher ids and parked / for-sale flags, the topic change points (\"changed 2019 → casino\") and since when the current topic is stable.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"domainUnicode":{"type":"string"},"periods":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"period":{"type":"integer","description":"Calendar year of the captures."},"from":{"type":"string"},"to":{"type":"string"},"captures":{"type":"integer"},"topicId":{"type":["string","null"]},"topicScore":{"type":"number"},"lang":{"type":["string","null"]},"cms":{"type":["string","null"]},"analyticsIds":{"type":"array","items":{"type":"string"}},"adPubIds":{"type":"array","items":{"type":"string"}},"parked":{"type":"boolean"},"forSale":{"type":"boolean"},"sources":{"type":"array","items":{"type":"string"}}},"required":["period","captures","topicId","parked","forSale"]}},"changes":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"period":{"type":"integer"},"from":{"type":"string"},"to":{"type":"string"},"score":{"type":"number"}},"required":["period","from","to"]}},"currentTopic":{"type":["string","null"]},"stableSince":{"type":["integer","null"],"description":"First period of the current topic run (\"topic stable since 2014\")."},"ownerSignals":{"type":"object","additionalProperties":false,"properties":{"analyticsIds":{"type":"array","items":{"type":"string"}},"adPubIds":{"type":"array","items":{"type":"string"}},"changedAt":{"type":"array","items":{"type":"integer"}}}},"asOf":{"type":["string","null"]}},"required":["domain","periods","changes","currentTopic","stableSince"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"archive","x-safety":"read","x-tenancy":"workspace","x-mcp-tool":"archive_topic_timeline"}},"/v1/domains/{domain}/archive/enrich":{"post":{"operationId":"archive.enrich","tags":["service"],"summary":"Enrich a domain from the archives","description":"Queues the archive enrichment of the domain now: web archive counters, then per period the home page (per year and on content changes) from the archives, robots / sitemap / ads.txt / favicon and a screenshot of the latest capture. Results: archive.stats, archive.topic_timeline.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"force":{"type":"boolean","default":false,"description":"Re-enrich periods that already have page facts."},"maxPeriods":{"type":"integer","minimum":1,"maximum":30},"screenshot":{"type":"boolean"},"callbackUrl":{"type":"string","format":"uri","maxLength":2000},"clientRef":{"type":"string","minLength":1,"maxLength":200}}}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","cancelled"]},"progressPct":{"type":"integer","minimum":0,"maximum":100},"ownerKind":{"type":"string","enum":["user","team","service_client","system"]},"ownerId":{"type":["string","null"]},"clientRef":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"failure":{"type":["object","null"],"additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"links":{"type":"object","additionalProperties":false,"properties":{"self":{"type":"string"},"result":{"type":"string"},"events":{"type":"string"},"logs":{"type":"string"}},"required":["self","result","events","logs"]}},"required":["id","kind","status","progressPct","ownerKind","ownerId","clientRef","createdAt","startedAt","completedAt","failure","links"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"archive","x-safety":"job","x-tenancy":"workspace","x-read-only-job":true,"x-mcp-tool":"archive_enrich"}},"/v1/watchlists":{"get":{"operationId":"watchLists","tags":["collections"],"summary":"Watch lists","description":"Watch lists of the personal workspace or of the X-Team-Id team, with their domain counts.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"count":{"type":"integer"},"createdBy":{"type":"string","enum":["user","agent"]},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]}},"required":["id","name","count"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"read","x-tenancy":"user","x-mcp-tool":"watchlists_list"},"post":{"operationId":"createWatchList","tags":["collections"],"summary":"Create watch list","description":"Creates a watch list (plan limit watchLists → 402 PLAN_LIMIT_REACHED; team: member+).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100}},"required":["name"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"count":{"type":"integer"},"createdBy":{"type":"string","enum":["user","agent"]},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]}},"required":["id","name","count"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"write","x-tenancy":"user","x-mcp-tool":"watchlist_create"}},"/v1/watchlists/{id}":{"patch":{"operationId":"renameWatchList","tags":["collections"],"summary":"Rename watch list","description":"Renames a watch list (team: member+).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"count":{"type":"integer"},"createdBy":{"type":"string","enum":["user","agent"]},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]}},"required":["id","name","count"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"write","x-tenancy":"user"},"delete":{"operationId":"deleteWatchList","tags":["collections"],"summary":"Delete watch list","description":"Deletes a watch list and its items (team: member+).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"write","x-tenancy":"user"}},"/v1/watchlists/{id}/items":{"get":{"operationId":"watchListItems","tags":["collections"],"summary":"Watch list items","description":"Domains of a watch list, newest first (cursor paging; page size capped by the plan rowsPerPage).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","required":["domain","unicode","zone","name","length","status","offers","metrics"],"properties":{"domain":{"type":"string"},"unicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"length":{"type":"integer"},"status":{"type":"string"},"offers":{"type":"array"},"metrics":{"type":"object"},"watched":{"type":"boolean"},"wished":{"type":"boolean"}}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"read","x-tenancy":"user"},"post":{"operationId":"addToWatchList","tags":["collections"],"summary":"Add to watch list","description":"Adds domains (normalized to the registrable domain) to a watch list and schedules them for frequent checks. Plan limit watchListNames (per list) → 402.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"domains":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300},"minItems":1,"maxItems":1000}},"required":["domains"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"count":{"type":"integer"},"createdBy":{"type":"string","enum":["user","agent"]},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]}},"required":["id","name","count"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"write","x-tenancy":"user","x-mcp-tool":"watchlist_add"},"delete":{"operationId":"removeFromWatchList","tags":["collections"],"summary":"Remove from watch list","description":"Removes domains from a watch list (team: member+).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"domains","in":"query","required":true,"schema":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300},"minItems":1,"maxItems":1000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"count":{"type":"integer"},"createdBy":{"type":"string","enum":["user","agent"]},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]}},"required":["id","name","count"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"write","x-tenancy":"user"}},"/v1/wishlist":{"get":{"operationId":"wishList","tags":["collections"],"summary":"Wish list","description":"Wished domains / names with their trigger and the last known status.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"trigger":{"type":"string","enum":["any_change","available","dropping","auction"]},"createdBy":{"type":"string","enum":["user","agent"]},"status":{"type":"string"}},"required":["id","name","createdBy"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"read","x-tenancy":"user","x-mcp-tool":"wishlist_list"},"post":{"operationId":"addWish","tags":["collections"],"summary":"Add wish","description":"Adds a domain (scheduled for frequent checks) or a name without zone to the wish list. Plan limit wishNames → 402.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":300},"trigger":{"type":"string","enum":["any_change","available","dropping","auction"]}},"required":["name"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"trigger":{"type":"string","enum":["any_change","available","dropping","auction"]},"createdBy":{"type":"string","enum":["user","agent"]},"status":{"type":"string"}},"required":["id","name","createdBy"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"write","x-tenancy":"user","x-mcp-tool":"wishlist_add"}},"/v1/wishlist/{id}":{"delete":{"operationId":"removeWish","tags":["collections"],"summary":"Remove wish","description":"Removes a wish (team: member+).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"write","x-tenancy":"user"}},"/v1/alerts":{"get":{"operationId":"alerts","tags":["collections"],"summary":"Alerts","description":"Alerts on a domain or a saved filter with their channels.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"target":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string","minLength":1,"maxLength":253},"savedFilterId":{"type":"string","minLength":1,"maxLength":64}}},"trigger":{"type":"string","enum":["status_change","becomes_available","new_matches"]},"channels":{"type":"array","items":{"type":"string","enum":["email","push","webhook"]},"maxItems":3},"webhookUrl":{"type":"string","format":"uri","maxLength":2000},"enabled":{"type":"boolean"},"id":{"type":"string"},"createdBy":{"type":"string","enum":["user","agent"]},"webhookSecret":{"type":"string","readOnly":true,"description":"Signing secret of the webhook channel (whsec_…); returned once, when the webhook channel is added."}},"required":["id","target","trigger","createdBy"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"read","x-tenancy":"user","x-mcp-tool":"alerts_list"},"post":{"operationId":"createAlert","tags":["collections"],"summary":"Create alert","description":"Creates an alert on a domain or a saved filter. Channels: email; push (plan feature push_alerts); webhook (Business, webhookUrl). Plan limit alerts → 402.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"target":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string","minLength":1,"maxLength":253},"savedFilterId":{"type":"string","minLength":1,"maxLength":64}}},"trigger":{"type":"string","enum":["status_change","becomes_available","new_matches"]},"channels":{"type":"array","items":{"type":"string","enum":["email","push","webhook"]},"maxItems":3},"webhookUrl":{"type":"string","format":"uri","maxLength":2000},"enabled":{"type":"boolean"}},"required":["target","trigger"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"target":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string","minLength":1,"maxLength":253},"savedFilterId":{"type":"string","minLength":1,"maxLength":64}}},"trigger":{"type":"string","enum":["status_change","becomes_available","new_matches"]},"channels":{"type":"array","items":{"type":"string","enum":["email","push","webhook"]},"maxItems":3},"webhookUrl":{"type":"string","format":"uri","maxLength":2000},"enabled":{"type":"boolean"},"id":{"type":"string"},"createdBy":{"type":"string","enum":["user","agent"]},"webhookSecret":{"type":"string","readOnly":true,"description":"Signing secret of the webhook channel (whsec_…); returned once, when the webhook channel is added."}},"required":["id","target","trigger","createdBy"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"write","x-tenancy":"user","x-mcp-tool":"alert_create"}},"/v1/alerts/{id}":{"patch":{"operationId":"updateAlert","tags":["collections"],"summary":"Update alert","description":"Replaces an alert (AlertInput); omitted channels / enabled keep their values.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"target":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string","minLength":1,"maxLength":253},"savedFilterId":{"type":"string","minLength":1,"maxLength":64}}},"trigger":{"type":"string","enum":["status_change","becomes_available","new_matches"]},"channels":{"type":"array","items":{"type":"string","enum":["email","push","webhook"]},"maxItems":3},"webhookUrl":{"type":"string","format":"uri","maxLength":2000},"enabled":{"type":"boolean"}},"required":["target","trigger"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"target":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string","minLength":1,"maxLength":253},"savedFilterId":{"type":"string","minLength":1,"maxLength":64}}},"trigger":{"type":"string","enum":["status_change","becomes_available","new_matches"]},"channels":{"type":"array","items":{"type":"string","enum":["email","push","webhook"]},"maxItems":3},"webhookUrl":{"type":"string","format":"uri","maxLength":2000},"enabled":{"type":"boolean"},"id":{"type":"string"},"createdBy":{"type":"string","enum":["user","agent"]},"webhookSecret":{"type":"string","readOnly":true,"description":"Signing secret of the webhook channel (whsec_…); returned once, when the webhook channel is added."}},"required":["id","target","trigger","createdBy"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"write","x-tenancy":"user"},"delete":{"operationId":"deleteAlert","tags":["collections"],"summary":"Delete alert","description":"Deletes an alert (team: member+).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"write","x-tenancy":"user"}},"/v1/saved-filters":{"get":{"operationId":"savedFilters","tags":["collections"],"summary":"Saved filters","description":"Saved list filters (list type, zone, SearchFilters).","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"listType":{"type":"string"},"zone":{"type":"string"},"filter":{"type":"object"}},"required":["id","name","listType","filter"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"read","x-tenancy":"user","x-mcp-tool":"saved_filters_list"},"post":{"operationId":"saveFilter","tags":["collections"],"summary":"Save filter","description":"Saves a list filter (plan limit savedFilters → 402; team: member+).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"listType":{"type":"string","minLength":1,"maxLength":40},"zone":{"type":"string","maxLength":100},"filter":{"type":"object"}},"required":["name","listType","filter"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"listType":{"type":"string"},"zone":{"type":"string"},"filter":{"type":"object"}},"required":["id","name","listType","filter"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"collections","x-safety":"write","x-tenancy":"user"}},"/v1/teams":{"get":{"operationId":"myTeams","tags":["teams"],"summary":"Teams I belong to (with my role)","description":"Teams the caller belongs to, with the caller's role.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"myRole":{"type":"string","enum":["owner","admin","member","viewer"]},"memberCount":{"type":"integer"},"maxMembers":{"type":"integer"},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"state":{"type":"string","enum":["active","read_only","archived"]},"aiTrainingOptOut":{"type":"boolean"}},"required":["id","name","myRole","memberCount","maxMembers"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"read","x-tenancy":"user"},"post":{"operationId":"createTeam","tags":["teams"],"summary":"Create a team (Business owner)","description":"Creates a team owned by the caller (plan feature teams: Business, else 402 FEATURE_LOCKED).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80}},"required":["name"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"myRole":{"type":"string","enum":["owner","admin","member","viewer"]},"memberCount":{"type":"integer"},"maxMembers":{"type":"integer"},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"state":{"type":"string","enum":["active","read_only","archived"]},"aiTrainingOptOut":{"type":"boolean"}},"required":["id","name","myRole","memberCount","maxMembers"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"write","x-tenancy":"user"}},"/v1/teams/{id}":{"get":{"operationId":"team","tags":["teams"],"summary":"Team","description":"A team the caller belongs to (403 NOT_A_MEMBER otherwise).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"myRole":{"type":"string","enum":["owner","admin","member","viewer"]},"memberCount":{"type":"integer"},"maxMembers":{"type":"integer"},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"state":{"type":"string","enum":["active","read_only","archived"]},"aiTrainingOptOut":{"type":"boolean"}},"required":["id","name","myRole","memberCount","maxMembers"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"read","x-tenancy":"user"},"patch":{"operationId":"updateTeam","tags":["teams"],"summary":"Rename team or set team spending limit (admin+)","description":"Renames the team, sets the team spending limit, or opts the team out of the use of its assistant requests to improve our own assistant models (admin+).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"aiTrainingOptOut":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"myRole":{"type":"string","enum":["owner","admin","member","viewer"]},"memberCount":{"type":"integer"},"maxMembers":{"type":"integer"},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"state":{"type":"string","enum":["active","read_only","archived"]},"aiTrainingOptOut":{"type":"boolean"}},"required":["id","name","myRole","memberCount","maxMembers"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"write","x-tenancy":"user"},"delete":{"operationId":"deleteTeam","tags":["teams"],"summary":"Delete team (owner)","description":"Deletes the team with its workspace, invitations, activity and team API keys (owner).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"write","x-tenancy":"user"}},"/v1/teams/{id}/transfer":{"post":{"operationId":"transferTeam","tags":["teams"],"summary":"Transfer ownership (owner)","description":"Makes another member the owner; the current owner becomes admin (owner).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},"required":["userId"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"myRole":{"type":"string","enum":["owner","admin","member","viewer"]},"memberCount":{"type":"integer"},"maxMembers":{"type":"integer"},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"state":{"type":"string","enum":["active","read_only","archived"]},"aiTrainingOptOut":{"type":"boolean"}},"required":["id","name","myRole","memberCount","maxMembers"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"write","x-tenancy":"user"}},"/v1/teams/{id}/members":{"get":{"operationId":"teamMembers","tags":["teams"],"summary":"Members with roles and limits","description":"Members with their roles, spending limits and join dates (any member).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string"},"email":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member","viewer"]},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"joinedAt":{"type":"string","format":"date-time"}},"required":["userId","email","role"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"read","x-tenancy":"user"}},"/v1/teams/{id}/members/{userId}":{"patch":{"operationId":"updateMember","tags":["teams"],"summary":"Change a member's role or spending limit (admin+)","description":"Changes a member's role (not to / from owner: use transfer) or spending limit (admin+).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"role":{"type":"string","enum":["owner","admin","member","viewer"]},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string"},"email":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member","viewer"]},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"joinedAt":{"type":"string","format":"date-time"}},"required":["userId","email","role"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"write","x-tenancy":"user"},"delete":{"operationId":"removeMember","tags":["teams"],"summary":"Remove a member (admin+) or leave (self)","description":"Removes a member (admin+) or leaves the team (self); the owner transfers ownership first.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"write","x-tenancy":"user"}},"/v1/teams/{id}/invitations":{"get":{"operationId":"teamInvitations","tags":["teams"],"summary":"Pending invitations (admin+)","description":"Pending, unexpired invitations (admin+).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"teamName":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member","viewer"]},"invitedBy":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"state":{"type":"string","enum":["pending","accepted","revoked","expired"]}},"required":["id","email","role","expiresAt"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"read","x-tenancy":"user"},"post":{"operationId":"invite","tags":["teams"],"summary":"Invite by email (admin+)","description":"Invites by email as admin / member / viewer (admin+); mails a link valid 7 days. Members + pending invitations count against teamMembers (402).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","format":"email","maxLength":320},"role":{"type":"string","enum":["owner","admin","member","viewer"]}},"required":["email","role"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"teamName":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member","viewer"]},"invitedBy":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"state":{"type":"string","enum":["pending","accepted","revoked","expired"]}},"required":["id","email","role","expiresAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"write","x-tenancy":"user"}},"/v1/teams/{id}/invitations/{invitationId}":{"delete":{"operationId":"revokeInvitation","tags":["teams"],"summary":"Revoke an invitation (admin+)","description":"Revokes a pending invitation; its link stops working (admin+).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"invitationId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"write","x-tenancy":"user"}},"/v1/teams/{id}/invitations/{invitationId}/resend":{"post":{"operationId":"resendInvitation","tags":["teams"],"summary":"Resend an invitation (admin+)","description":"Mails a new link (the previous one stops working), valid 7 more days (admin+).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"invitationId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"write","x-tenancy":"user"}},"/v1/teams/{id}/activity":{"get":{"operationId":"teamActivity","tags":["teams"],"summary":"Activity log (admin+)","description":"Activity log of the team, newest first (admin+; cursor paging).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"at":{"type":"string","format":"date-time"},"actor":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string"},"email":{"type":"string"},"via":{"type":"string","enum":["app","agent","api","mcp"]}}},"action":{"type":"string"},"target":{"type":"string"},"detail":{"type":"object"}},"required":["at","actor","action"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"read","x-tenancy":"user"}},"/v1/invitations/{token}":{"get":{"operationId":"invitationInfo","tags":["teams"],"summary":"Invitation details for the accept page","description":"Team, inviter, role and expiry of an invitation link (public); 410 INVITATION_INVALID when used, revoked or expired.","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"teamName":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member","viewer"]},"invitedBy":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"state":{"type":"string","enum":["pending","accepted","revoked","expired"]}},"required":["id","email","role","expiresAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"read","x-tenancy":"public"}},"/v1/invitations/{token}/accept":{"post":{"operationId":"acceptInvitation","tags":["teams"],"summary":"Accept (signed in)","description":"Joins the team with the invited role (signed in); 410 INVITATION_INVALID when used, revoked or expired.","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"myRole":{"type":"string","enum":["owner","admin","member","viewer"]},"memberCount":{"type":"integer"},"maxMembers":{"type":"integer"},"spendingLimit":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}}},"state":{"type":"string","enum":["active","read_only","archived"]},"aiTrainingOptOut":{"type":"boolean"}},"required":["id","name","myRole","memberCount","maxMembers"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"teams","x-safety":"write","x-tenancy":"user"}},"/v1/plans":{"get":{"operationId":"plans","tags":["public"],"summary":"Plans","description":"Plans with prices, limits and features; `channels` tells which purchase channels are configured for each plan (the app hides unavailable purchase buttons).","security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"prices":{"type":"object","additionalProperties":false,"properties":{"monthly":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}}},"yearly":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}}}}},"limits":{"type":"object","additionalProperties":{"type":["integer","null"]}},"features":{"type":"array","items":{"type":"string"}},"storeProductIds":{"type":"object"},"channels":{"type":"object","additionalProperties":false,"properties":{"stripe":{"type":"boolean"},"app_store":{"type":"boolean"},"play":{"type":"boolean"}}}},"required":["id","name","prices","limits","features"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"}},"x-toolset":"public","x-safety":"read","x-tenancy":"public"}},"/v1/billing/stripe/checkout":{"post":{"operationId":"stripeCheckout","tags":["billing"],"summary":"Web and desktop-outside-stores only","description":"Creates a Stripe Checkout Session (subscription mode) for the plan and interval and returns its URL. With X-Team-Id the team subscribes (team owner only). 409 when a Stripe subscription is already active (use the portal); 503 NOT_CONFIGURED without Stripe keys.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"planId":{"type":"string","minLength":1,"maxLength":32},"interval":{"type":"string","enum":["monthly","yearly"]}},"required":["planId","interval"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string"}},"required":["url"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"billing","x-safety":"write","x-tenancy":"user"}},"/v1/billing/stripe/portal":{"post":{"operationId":"stripePortal","tags":["billing"],"summary":"Stripe portal","description":"Creates a Stripe Billing Portal session (change plan, payment method, cancel) and returns its URL. 404 without a Stripe customer; 503 NOT_CONFIGURED without Stripe keys.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string"}},"required":["url"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"billing","x-safety":"write","x-tenancy":"user"}},"/v1/billing/iap/verify":{"post":{"operationId":"verifyStorePurchase","tags":["billing"],"summary":"Verify store purchase","description":"Verifies a store purchase; returns the entitlement. iOS / macOS: `receipt` = StoreKit 2 signed transaction (JWS, Apple Root CA - G3; Server API status when configured). Android: `purchaseToken` (Play subscriptionsv2, acknowledged). 409 when linked to another account; 503 NOT_CONFIGURED for an unconfigured store.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"platform":{"type":"string","enum":["ios","macos","android"]},"productId":{"type":"string","minLength":1,"maxLength":200},"receipt":{"type":"string","minLength":1,"maxLength":65536},"purchaseToken":{"type":"string","minLength":1,"maxLength":4096}},"required":["platform","productId"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"planId":{"type":"string"},"channel":{"type":"string","enum":["none","stripe","app_store","play"]},"status":{"type":"string","enum":["none","active","trialing","grace"]},"renewsAt":{"type":["string","null"],"format":"date-time"},"periodEnd":{"type":["string","null"],"format":"date-time"},"graceUntil":{"type":["string","null"],"format":"date-time"},"cancelAt":{"type":["string","null"],"format":"date-time"},"manageUrl":{"type":["string","null"]},"subscriptions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"channel":{"type":"string","enum":["stripe","app_store","play","manual"]},"planId":{"type":"string"},"status":{"type":"string"},"interval":{"type":["string","null"],"enum":["monthly","yearly",null]},"periodEnd":{"type":["string","null"],"format":"date-time"},"cancelAt":{"type":["string","null"],"format":"date-time"},"graceUntil":{"type":["string","null"],"format":"date-time"},"manageUrl":{"type":["string","null"]}},"required":["channel","planId","status"]}}},"required":["planId","channel"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"billing","x-safety":"write","x-tenancy":"user"}},"/v1/me/promo-codes":{"post":{"operationId":"redeemPromoCode","tags":["billing"],"summary":"Redeem a promo code","description":"Redeems a promo code for the context (personal, or with X-Team-Id the team: owner or admin). The code's plan applies for its number of days alongside any subscription (the highest plan wins). 404 INVALID_PROMO for a code that cannot be redeemed (one answer whatever the reason); 409 CONFLICT when already redeemed; 429 after too many attempts.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","minLength":1,"maxLength":64}},"required":["code"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"planId":{"type":"string"},"until":{"type":["string","null"],"format":"date-time"},"entitlement":{"type":"object","additionalProperties":false,"properties":{"planId":{"type":"string"},"channel":{"type":"string","enum":["none","stripe","app_store","play"]},"status":{"type":"string","enum":["none","active","trialing","grace"]},"renewsAt":{"type":["string","null"],"format":"date-time"},"periodEnd":{"type":["string","null"],"format":"date-time"},"graceUntil":{"type":["string","null"],"format":"date-time"},"cancelAt":{"type":["string","null"],"format":"date-time"},"manageUrl":{"type":["string","null"]},"subscriptions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"channel":{"type":"string","enum":["stripe","app_store","play","manual"]},"planId":{"type":"string"},"status":{"type":"string"},"interval":{"type":["string","null"],"enum":["monthly","yearly",null]},"periodEnd":{"type":["string","null"],"format":"date-time"},"cancelAt":{"type":["string","null"],"format":"date-time"},"graceUntil":{"type":["string","null"],"format":"date-time"},"manageUrl":{"type":["string","null"]}},"required":["channel","planId","status"]}}},"required":["planId","channel"]}},"required":["planId","until","entitlement"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"billing","x-safety":"write","x-tenancy":"user"}},"/v1/providers":{"get":{"operationId":"providers","tags":["accounts"],"summary":"Providers","description":"Providers users can connect accounts for: what each can do (offer kinds) and which key fields it needs.","security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string","enum":["register","backorder","bid","buy_now"]}},"credentialFields":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"label":{"type":"string"},"secret":{"type":"boolean"}},"required":["name","label","secret"]}},"docsUrl":{"type":"string"}},"required":["id","name","capabilities","credentialFields"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"}},"x-toolset":"accounts","x-safety":"read","x-tenancy":"public"}},"/v1/accounts":{"get":{"operationId":"accounts","tags":["accounts"],"summary":"Accounts","description":"Connected provider accounts of the personal / X-Team-Id workspace (keys are never returned; masked hint only).","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"providerId":{"type":"string"},"name":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string","enum":["register","backorder","bid","buy_now"]}},"status":{"type":"string","enum":["ok","invalid_key","expired","error"]},"defaultFor":{"type":"array","items":{"type":"string","enum":["register","backorder","bid","buy_now"]}},"maskedKey":{"type":"string"},"lastTestAt":{"type":"string","format":"date-time"},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]}},"required":["id","providerId","name","capabilities","status"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"accounts","x-safety":"read","x-tenancy":"user","x-mcp-tool":"accounts_list"},"post":{"operationId":"connectAccount","tags":["accounts"],"summary":"Connect account","description":"Connects a provider account (key fields per the provider catalog; stored encrypted) and tests it right away. Plan limit accountsPerProvider → 402; team: admin+.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"providerId":{"type":"string","minLength":1,"maxLength":40},"name":{"type":"string","minLength":1,"maxLength":200},"credentials":{"type":"object","additionalProperties":{"type":"string","maxLength":4096},"maxProperties":10,"writeOnly":true}},"required":["providerId","name","credentials"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"providerId":{"type":"string"},"name":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string","enum":["register","backorder","bid","buy_now"]}},"status":{"type":"string","enum":["ok","invalid_key","expired","error"]},"defaultFor":{"type":"array","items":{"type":"string","enum":["register","backorder","bid","buy_now"]}},"maskedKey":{"type":"string"},"lastTestAt":{"type":"string","format":"date-time"},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]}},"required":["id","providerId","name","capabilities","status"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"accounts","x-safety":"write","x-tenancy":"user"}},"/v1/accounts/{id}":{"patch":{"operationId":"updateAccount","tags":["accounts"],"summary":"Update account","description":"Renames an account, sets the kinds it is the default for, or replaces key fields (re-tested). Team: admin+.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"defaultFor":{"type":"array","items":{"type":"string","enum":["register","backorder","bid","buy_now"]},"maxItems":4},"credentials":{"type":"object","additionalProperties":{"type":"string","maxLength":4096},"maxProperties":10,"writeOnly":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"providerId":{"type":"string"},"name":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string","enum":["register","backorder","bid","buy_now"]}},"status":{"type":"string","enum":["ok","invalid_key","expired","error"]},"defaultFor":{"type":"array","items":{"type":"string","enum":["register","backorder","bid","buy_now"]}},"maskedKey":{"type":"string"},"lastTestAt":{"type":"string","format":"date-time"},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]}},"required":["id","providerId","name","capabilities","status"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"accounts","x-safety":"write","x-tenancy":"user"},"delete":{"operationId":"disconnectAccount","tags":["accounts"],"summary":"Disconnect account","description":"Disconnects an account and deletes its stored key (orders keep their history). Team: admin+.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"accounts","x-safety":"write","x-tenancy":"user"}},"/v1/accounts/{id}/test":{"post":{"operationId":"testAccount","tags":["accounts"],"summary":"Test account","description":"Tests the stored key with the provider; the account status becomes ok or invalid_key.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"ok":{"type":"boolean"},"capabilities":{"type":"array","items":{"type":"string","enum":["register","backorder","bid","buy_now"]}},"message":{"type":"string"}},"required":["ok","capabilities"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"accounts","x-safety":"write","x-tenancy":"user"}},"/v1/orders/preview":{"post":{"operationId":"previewOrder","tags":["orders"],"summary":"Step 1 of every order (also for the agent and MCP) — nothing is charged","description":"Step 1 of every order: the price, fees, terms and spending-limit check for an offer, with a preview token valid for 10 minutes. Nothing is ordered or charged.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string","minLength":1,"maxLength":300},"offerId":{"type":"string","minLength":3,"maxLength":400},"accountId":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"},"maxBid":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"origin":{"type":"object","additionalProperties":false,"properties":{"client":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[a-z0-9_.-]+$"},"via":{"type":"string","enum":["agent","app","api"]},"turnId":{"type":"string","minLength":1,"maxLength":128}},"required":["client","via"]}},"required":["domain","offerId"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"previewToken":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"domain":{"type":"string"},"offer":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"minNextBid":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"bids":{"type":"integer"},"endsAt":{"type":["string","null"],"format":"date-time"},"termsUrl":{"type":"string"}},"required":["id","kind","provider","price"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"fees":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"chargedOnlyIfCaught":{"type":"boolean"},"account":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"providerId":{"type":"string"},"name":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string","enum":["register","backorder","bid","buy_now"]}},"status":{"type":"string","enum":["ok","invalid_key","expired","error"]},"defaultFor":{"type":"array","items":{"type":"string","enum":["register","backorder","bid","buy_now"]}},"maskedKey":{"type":"string"},"lastTestAt":{"type":"string","format":"date-time"},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]}},"required":["id","providerId","name","capabilities","status"]},"termsUrl":{"type":"string"},"limitCheck":{"type":"object","additionalProperties":false,"properties":{"ok":{"type":"boolean"},"failed":{"type":["string","null"],"enum":["personal","team","member",null]},"perOrder":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"perDay":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"usedToday":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]}},"required":["ok"]}},"required":["previewToken","expiresAt","domain","offer","price","limitCheck"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"orders","x-safety":"write","x-tenancy":"user","x-mcp-tool":"order_preview"}},"/v1/orders":{"post":{"operationId":"confirmOrder","tags":["orders"],"summary":"Step 2 — explicit confirmation with the preview token; charges the connected account","description":"Step 2: places the previewed order in the connected account (single use; spending limits are checked again). The provider charges the account. API keys / MCP: \"confirm\": true. origin: optional (default: the preview's).\n\nRequires `confirm: true`; without it the API answers 428 with a dry-run preview.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"previewToken":{"type":"string","minLength":8,"maxLength":200},"origin":{"type":"object","additionalProperties":false,"properties":{"client":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[a-z0-9_.-]+$"},"via":{"type":"string","enum":["agent","app","api"]},"turnId":{"type":"string","minLength":1,"maxLength":128}},"required":["client","via"]},"confirm":{"type":"boolean","description":"Must be true to execute; otherwise 428 with a dry-run preview."}},"required":["previewToken"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}}},"accountId":{"type":"string"},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"status":{"type":"string","enum":["pending","waiting_drop","winning","outbid","won","lost","caught","not_caught","purchased","registered","transferred","failed","cancelled"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"endsAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"string","enum":["user","agent","api"]},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]},"placedBy":{"type":"string"},"providerUrl":{"type":"string"},"origin":{"type":["object","null"],"additionalProperties":false,"properties":{"client":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[a-z0-9_.-]+$"},"via":{"type":"string","enum":["agent","app","api"]},"turnId":{"type":"string","minLength":1,"maxLength":128}},"required":["client","via"]}},"required":["id","domain","kind","provider","status","createdAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"428":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"orders","x-safety":"money","x-tenancy":"user","x-mcp-tool":"order_confirm"},"get":{"operationId":"orders","tags":["orders"],"summary":"Orders","description":"Orders of the personal / X-Team-Id workspace, newest first, with their provider status.","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["register","backorder","bid","buy_now"]}},{"name":"status","in":"query","required":false,"schema":{"type":"string","maxLength":40}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}}},"accountId":{"type":"string"},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"status":{"type":"string","enum":["pending","waiting_drop","winning","outbid","won","lost","caught","not_caught","purchased","registered","transferred","failed","cancelled"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"endsAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"string","enum":["user","agent","api"]},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]},"placedBy":{"type":"string"},"providerUrl":{"type":"string"},"origin":{"type":["object","null"],"additionalProperties":false,"properties":{"client":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[a-z0-9_.-]+$"},"via":{"type":"string","enum":["agent","app","api"]},"turnId":{"type":"string","minLength":1,"maxLength":128}},"required":["client","via"]}},"required":["id","domain","kind","provider","status","createdAt"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"orders","x-safety":"read","x-tenancy":"user","x-mcp-tool":"orders_list"}},"/v1/orders/{id}/cancel":{"post":{"operationId":"cancelOrder","tags":["orders"],"summary":"Cancel order","description":"Cancels an order where the provider allows it; otherwise 409 with the provider's terms.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"domain":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}}},"accountId":{"type":"string"},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"status":{"type":"string","enum":["pending","waiting_drop","winning","outbid","won","lost","caught","not_caught","purchased","registered","transferred","failed","cancelled"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"endsAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"string","enum":["user","agent","api"]},"owner":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["user","team"]},"id":{"type":"string"}},"required":["type","id"]},"placedBy":{"type":"string"},"providerUrl":{"type":"string"},"origin":{"type":["object","null"],"additionalProperties":false,"properties":{"client":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[a-z0-9_.-]+$"},"via":{"type":"string","enum":["agent","app","api"]},"turnId":{"type":"string","minLength":1,"maxLength":128}},"required":["client","via"]}},"required":["id","domain","kind","provider","status","createdAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"orders","x-safety":"write","x-tenancy":"user"}},"/v1/public/stats":{"get":{"operationId":"publicStats","tags":["public"],"summary":"Public stats","description":"Landing counters from fresh facts only: names dropping today (drop lists), live auctions (end time in the future), sources with fresh data (no longer shown) and domainsTotal = domains in the database (every name we track, cached 1 h).","security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"droppingToday":{"type":"integer"},"liveAuctions":{"type":"integer"},"sources":{"type":"integer"},"domainsTotal":{"type":"integer"}},"required":["droppingToday","liveAuctions","sources","domainsTotal"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"}},"x-toolset":"public","x-safety":"read","x-tenancy":"public"}},"/v1/public/sources":{"get":{"operationId":"publicSources","tags":["public"],"summary":"Public sources","description":"Covered sources (drop lists, auction houses, WHOIS / RDAP, web archive, domain check stages) with the last observation time; `state` done = observed within 48 h, timeout = stale; `count` = currently fresh rows.","security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","name","state"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["registrar","auction","dropcatch","marketplace","list"]},"state":{"type":"string","enum":["pending","done","failed","timeout"]},"updatedAt":{"type":["string","null"]},"count":{"type":"integer"},"health":{"type":"string","enum":["fresh","stale","failed"]},"reason":{"type":["string","null"]},"lastSuccessAt":{"type":["string","null"]}}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"}},"x-toolset":"public","x-safety":"read","x-tenancy":"public"}},"/v1/public/domains/{domain}":{"get":{"operationId":"publicDomain","tags":["public"],"summary":"Public domain","description":"SEO domain page data (DomainDetails without workspace flags); 404 NOT_FOUND for a name no source has seen.","security":[],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["domain","unicode","zone","name","length","status","offers","metrics"],"properties":{"domain":{"type":"string"},"unicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"length":{"type":"integer"},"status":{"type":"string","enum":["available","auction","dropping","expiring","buy_now","taken","unknown"]},"statusAsOf":{"type":["string","null"]},"offers":{"type":"array","items":{"type":"object","required":["id","kind","provider","price"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"minNextBid":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"bids":{"type":"integer"},"endsAt":{"type":["string","null"]},"termsUrl":{"type":"string"}}}},"metrics":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"value":{"type":["number","null"]},"asOf":{"type":["string","null"]}},"required":["value","asOf"]}},"otherZones":{"type":"array","items":{"type":"string"}},"topic":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}},"coreTop":{"type":"string"},"enrolledTier":{"type":["integer","null"]},"watched":{"type":"boolean"},"wished":{"type":"boolean"},"freshness":{"type":"string","enum":["fresh","aging","stale"]},"refreshing":{"type":"boolean"},"group":{"type":"string","enum":["obtainable","taken","unknown"]},"droppedAt":{"type":["string","null"]},"core":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string"},"volume":{"type":"integer"},"position":{"type":"integer"}},"required":["keyword"]}},"history":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"date":{"type":"string"},"event":{"type":"string","enum":["registered","expired","dropped","transferred","auctioned","sold","site_copied"]},"detail":{"type":"string"}}}},"archive":{"type":"object","additionalProperties":false,"properties":{"firstCapture":{"type":["string","null"]},"lastCapture":{"type":["string","null"]},"snapshotsByYear":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"year":{"type":"integer"},"count":{"type":"integer"}}}},"crawls":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"crawl":{"type":"string"},"year":{"type":"integer"},"pages":{"type":"integer"},"htmlPages":{"type":"integer"},"home":{"type":["string","null"]}},"required":["crawl","year","pages"]}},"crawlFirstSeen":{"type":["string","null"]},"crawlLastSeen":{"type":["string","null"]}}},"linkingPages":{"type":"object","additionalProperties":false,"properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string"},"domain":{"type":"string"},"targetUrl":{"type":"string"},"anchor":{"type":"string"},"nofollow":{"type":"boolean"},"seenAt":{"type":["string","null"]}},"required":["url","domain"]}}},"required":["total","items"]},"whois":{"type":"object","additionalProperties":false,"properties":{"registrar":{"type":["string","null"]},"created":{"type":["string","null"]},"expires":{"type":["string","null"]},"status":{"type":"array","items":{"type":"string"}},"nameservers":{"type":"array","items":{"type":"string"}}}},"topicHistory":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"year":{"type":"integer"},"topic":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}},"change":{"type":"string","enum":["major","minor"]}},"required":["year","topic"]}},"quality":{"type":"object","additionalProperties":false,"properties":{"score":{"type":"integer","minimum":0,"maximum":100},"coverage":{"type":"number","minimum":0,"maximum":1},"passed":{"type":"integer"},"failed":{"type":"integer"},"unknown":{"type":"integer"},"checks":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","enum":["indexed","favicon","archive_pages","referring_sites","no_glue","search_history","free_verified"]},"state":{"type":"string","enum":["pass","fail","unknown"]},"value":{"type":["number","null"]},"threshold":{"type":["number","null"]},"evidence":{"type":"string"},"source":{"type":["string","null"]},"asOf":{"type":["string","null"]},"applicable":{"type":"boolean"}},"required":["id","state","evidence","asOf","applicable"]}},"asOf":{"type":"string"}},"required":["score","coverage","checks","asOf"]},"glue":{"type":"object","additionalProperties":false,"properties":{"glued":{"type":["boolean","null"]},"hosts":{"type":"array","items":{"type":"string"}},"evidence":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["search_index","redirect","canonical","wayback_redirect","wayback_canonical"]},"source":{"type":"string"},"url":{"type":"string"},"target":{"type":"string"},"asOf":{"type":["string","null"]}},"required":["kind","source","url","target","asOf"]}},"checked":{"type":"array","items":{"type":"string","enum":["search_index","redirect","canonical","wayback_redirect","wayback_canonical"]}},"asOf":{"type":["string","null"]}},"required":["glued","hosts","evidence","checked"]},"adsTxt":{"type":"object","additionalProperties":false,"properties":{"present":{"type":["boolean","null"]},"sellers":{"type":"integer"},"direct":{"type":"integer"},"reseller":{"type":"integer"},"systems":{"type":"array","items":{"type":"string"}},"source":{"type":["string","null"]},"asOf":{"type":["string","null"]}},"required":["present","sellers"]},"buyingAdvice":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["backorder","register","none"]},"reasoning":{"type":"string"},"options":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"action":{"type":"string","enum":["backorder","register"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"url":{"type":"string"},"offerId":{"type":"string"},"cheapest":{"type":"boolean"}},"required":["provider","action","url"]}}},"required":["kind","reasoning","options"]}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}},"x-toolset":"public","x-safety":"read","x-tenancy":"public"}},"/v1/public/topics":{"get":{"operationId":"publicTopics","tags":["public"],"summary":"Site topics","description":"Topic catalogue (IAB Tech Lab Content Taxonomy 3.1, CC BY 3.0) as tree rows (id, parentId, tier, name); `tier=1`: tier 1 only. Names in `lang` or the Accept-Language language (en, ru, zh, hi, th). A topic filter matches descendants; old ids (coffee …) are aliases for one release.","security":[],"parameters":[{"name":"tier","in":"query","required":false,"schema":{"type":"string","enum":["1","all"]}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","ru","zh","hi","th"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"}},"x-toolset":"public","x-safety":"read","x-tenancy":"public"}},"/v1/public/media/{domain}/{kind}":{"get":{"operationId":"publicMedia","tags":["public"],"summary":"Domain favicon / screenshot","description":"Favicon (PNG, `size` 32 / 64 px) or home-page screenshot (480 px WebP) of a domain from images we fetched ourselves: 302 to /v1/public/media/raw/{sha256}.{png|webp} (immutable), made on the first request; 404 (cached a day) when there is none.","security":[],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}},{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["favicon","screenshot"]}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","enum":[32,64]}}],"responses":{"302":{"description":"Raw bytes","content":{"application/octet-stream":{"schema":{"type":"string","contentEncoding":"binary"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}},"x-toolset":"public","x-safety":"read","x-tenancy":"public"}},"/v1/public/media/raw/{file}":{"get":{"operationId":"publicMediaRaw","tags":["public"],"summary":"Media thumbnail (content-addressed)","description":"A thumbnail made by publicMedia (content-addressed `<sha256>.png` / `.webp`), `Cache-Control: public, max-age=31536000, immutable`.","security":[],"parameters":[{"name":"file","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}\\.(png|webp)$"}}],"responses":{"200":{"description":"Raw bytes","content":{"application/octet-stream":{"schema":{"type":"string","contentEncoding":"binary"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}},"x-toolset":"public","x-safety":"read","x-tenancy":"public"}},"/v1/public/topics/{id}/page":{"get":{"operationId":"publicTopicPage","tags":["public"],"summary":"Topic page","description":"SEO topic page (every IAB topic; `root` = index): path, subtopics, top 10 subtopics, two top-10 lists of obtainable domains (best quality by value; best for the registration price), up to 50 domains by value, promising keywords. id = topic id, slug or root. indexable = at least 10 obtainable domains.","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[A-Za-z0-9_.-]+$"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","ru","th","zh","hi"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"slug":{"type":"string"},"lang":{"type":"string"},"tier":{"type":"integer"},"name":{"type":"string"},"gloss":{"type":"string"},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"tier":{"type":"integer"}},"required":["id","slug","name","tier"]}},"children":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"tier":{"type":"integer"},"obtainable":{"type":"integer"},"indexable":{"type":"boolean"}},"required":["id","slug","name","tier","obtainable","indexable"]}},"topSubtopics":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"tier":{"type":"integer"},"obtainable":{"type":"integer"},"indexable":{"type":"boolean"},"offerScore":{"type":"number"},"bestValue":{"type":["number","null"]}},"required":["id","slug","name","tier","obtainable","indexable","offerScore","bestValue"]}},"topTopics":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"tier":{"type":"integer"},"obtainable":{"type":"integer"},"indexable":{"type":"boolean"},"offerScore":{"type":"number"},"bestValue":{"type":["number","null"]}},"required":["id","slug","name","tier","obtainable","indexable","offerScore","bestValue"]}},"topics":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"tier":{"type":"integer"},"obtainable":{"type":"integer"},"indexable":{"type":"boolean"},"parentId":{"type":["string","null"]},"changedAt":{"type":["string","null"]}},"required":["id","slug","name","tier","obtainable","indexable","parentId","changedAt"]}},"obtainable":{"type":"integer"},"regPrice":{"type":"integer"},"indexable":{"type":"boolean"},"bestQuality":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"status":{"type":"string"},"value":{"type":"number"},"regPrice":{"type":"boolean"},"qualityScore":{"type":"integer"},"refdomains":{"type":"integer"},"historyYears":{"type":"integer"},"firstYear":{"type":["integer","null"]},"lang":{"type":["string","null"]},"topicId":{"type":["string","null"]},"availableAt":{"type":["string","null"]},"favicon":{"type":["string","null"]}},"required":["domain","status","value","regPrice","qualityScore","refdomains","historyYears","firstYear","lang","topicId","availableAt","favicon"]}},"bestRegPrice":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"status":{"type":"string"},"value":{"type":"number"},"regPrice":{"type":"boolean"},"qualityScore":{"type":"integer"},"refdomains":{"type":"integer"},"historyYears":{"type":"integer"},"firstYear":{"type":["integer","null"]},"lang":{"type":["string","null"]},"topicId":{"type":["string","null"]},"availableAt":{"type":["string","null"]},"favicon":{"type":["string","null"]}},"required":["domain","status","value","regPrice","qualityScore","refdomains","historyYears","firstYear","lang","topicId","availableAt","favicon"]}},"domains":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"status":{"type":"string"},"value":{"type":"number"},"regPrice":{"type":"boolean"},"qualityScore":{"type":"integer"},"refdomains":{"type":"integer"},"historyYears":{"type":"integer"},"firstYear":{"type":["integer","null"]},"lang":{"type":["string","null"]},"topicId":{"type":["string","null"]},"availableAt":{"type":["string","null"]},"favicon":{"type":["string","null"]}},"required":["domain","status","value","regPrice","qualityScore","refdomains","historyYears","firstYear","lang","topicId","availableAt","favicon"]}},"keywords":{"type":"object","additionalProperties":false,"properties":{"head":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string"},"domains":{"type":"integer"},"relFreq":{"type":"number"},"promisingDomains":{"type":"integer"},"examples":{"type":"array","items":{"type":"string"}},"volume":{"type":["integer","null"]}},"required":["keyword","domains","relFreq","promisingDomains","examples","volume"]}},"longTail":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string"},"domains":{"type":"integer"},"relFreq":{"type":"number"},"promisingDomains":{"type":"integer"},"examples":{"type":"array","items":{"type":"string"}},"volume":{"type":["integer","null"]}},"required":["keyword","domains","relFreq","promisingDomains","examples","volume"]}},"volumes":{"type":"string","enum":["relative","search_volume"]}},"required":["head","longTail","volumes"]},"asOf":{"type":["string","null"]},"builtAt":{"type":["string","null"]},"changedAt":{"type":["string","null"]}},"required":["id","slug","lang","tier","name","gloss","path","children","topSubtopics","obtainable","regPrice","indexable","bestQuality","bestRegPrice","domains","keywords","asOf"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}},"x-toolset":"public","x-safety":"read","x-tenancy":"public"}},"/v1/search":{"post":{"operationId":"search","tags":["search"],"summary":"Start a search (guests allowed within the guest quota)","description":"Starts a search. kind: domain (name + its other zones), name (label in all zones), keywords (names + site keywords); agent = keywords + meta.notice. First page from stored data (no live RDAP; meta.refresh); drops, auctions, archive, refreshes stream on /events. Grouped obtainable → taken → unknown (groups); filters.obtainableOnly, filters.languages (history language). Limits: 402 / 429.","security":[{},{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"q":{"type":"string","minLength":1,"maxLength":2000},"kind":{"type":"string","enum":["domain","name","keywords","agent"]},"filters":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string","enum":["all","new","history","auction"]},"historyKinds":{"type":"array","items":{"type":"string","enum":["deleted","pending","expiring"]},"maxItems":3},"zones":{"type":"array","items":{"type":"string","minLength":1,"maxLength":63},"maxItems":200},"lengthMin":{"type":"integer","minimum":0,"maximum":253},"lengthMax":{"type":"integer","minimum":0,"maximum":253},"charset":{"type":"object","additionalProperties":false,"properties":{"letters":{"type":"boolean"},"digits":{"type":"boolean"},"hyphens":{"type":"boolean"}}},"keywordPosition":{"type":"string","enum":["anywhere","starts","ends"]},"ageMin":{"type":"integer","minimum":0},"backlinksMin":{"type":"integer","minimum":0},"referringDomainsMin":{"type":"integer","minimum":0},"archiveFirstYearMax":{"type":"integer","minimum":0},"archiveSnapshotsMin":{"type":"integer","minimum":0},"tfMin":{"type":"integer","minimum":0},"cfMin":{"type":"integer","minimum":0},"otherZonesMin":{"type":"integer","minimum":0},"searchVolumeMin":{"type":"integer","minimum":0},"priceMin":{"type":"number","minimum":0},"priceMax":{"type":"number","minimum":0},"withinDays":{"type":"integer","minimum":0,"maximum":3650},"sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":50},"topics":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":50},"coreKeyword":{"type":"string","maxLength":100},"obtainableOnly":{"type":"boolean"},"languages":{"type":"array","items":{"type":"string","pattern":"^[a-z]{2,3}$"},"maxItems":20}}}},"required":["q"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"searchId":{"type":"string"},"kind":{"type":"string"},"primary":{"type":"object","required":["domain","unicode","zone","name","length","status","offers","metrics"],"properties":{"domain":{"type":"string"},"unicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"length":{"type":"integer"},"status":{"type":"string","enum":["available","auction","dropping","expiring","buy_now","taken","unknown"]},"statusAsOf":{"type":["string","null"]},"offers":{"type":"array","items":{"type":"object","required":["id","kind","provider","price"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"minNextBid":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"bids":{"type":"integer"},"endsAt":{"type":["string","null"]},"termsUrl":{"type":"string"}}}},"metrics":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"value":{"type":["number","null"]},"asOf":{"type":["string","null"]}},"required":["value","asOf"]}},"otherZones":{"type":"array","items":{"type":"string"}},"topic":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}},"coreTop":{"type":"string"},"enrolledTier":{"type":["integer","null"]},"watched":{"type":"boolean"},"wished":{"type":"boolean"},"freshness":{"type":"string","enum":["fresh","aging","stale"]},"refreshing":{"type":"boolean"},"group":{"type":"string","enum":["obtainable","taken","unknown"]},"droppedAt":{"type":["string","null"]}}},"zones":{"type":"array","items":{"type":"object"}},"items":{"type":"array","items":{"type":"object","required":["domain","unicode","zone","name","length","status","offers","metrics"],"properties":{"domain":{"type":"string"},"unicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"length":{"type":"integer"},"status":{"type":"string","enum":["available","auction","dropping","expiring","buy_now","taken","unknown"]},"statusAsOf":{"type":["string","null"]},"offers":{"type":"array","items":{"type":"object","required":["id","kind","provider","price"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"minNextBid":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"bids":{"type":"integer"},"endsAt":{"type":["string","null"]},"termsUrl":{"type":"string"}}}},"metrics":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"value":{"type":["number","null"]},"asOf":{"type":["string","null"]}},"required":["value","asOf"]}},"otherZones":{"type":"array","items":{"type":"string"}},"topic":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}},"coreTop":{"type":"string"},"enrolledTier":{"type":["integer","null"]},"watched":{"type":"boolean"},"wished":{"type":"boolean"},"freshness":{"type":"string","enum":["fresh","aging","stale"]},"refreshing":{"type":"boolean"},"group":{"type":"string","enum":["obtainable","taken","unknown"]},"droppedAt":{"type":["string","null"]}}}},"tabs":{"type":"object"},"groups":{"type":"object","additionalProperties":false,"properties":{"obtainable":{"type":"integer"},"taken":{"type":"integer"},"unknown":{"type":"integer"}},"required":["obtainable","taken","unknown"]},"sources":{"type":"array","items":{"type":"object","required":["id","name","state"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["registrar","auction","dropcatch","marketplace","list"]},"state":{"type":"string","enum":["pending","done","failed","timeout"]},"updatedAt":{"type":["string","null"]},"count":{"type":"integer"},"health":{"type":"string","enum":["fresh","stale","failed"]},"reason":{"type":["string","null"]},"lastSuccessAt":{"type":["string","null"]}}}}},"required":["searchId","kind","items","sources"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"}},"x-toolset":"search","x-safety":"write","x-tenancy":"public","x-mcp-tool":"search_domains"}},"/v1/search/{searchId}/events":{"get":{"operationId":"searchEvents","tags":["search"],"summary":"Server-sent events for a search","description":"text/event-stream of a search: items.added {items} per streamed source, source.done {source, state, count}, then completed {total} (error {code, message} first when the search failed); refresh.queued {items: [{domain, refresh}]} and primary.updated / zones.updated / items.updated as queued status refreshes land (up to 60 s).","security":[{},{"bearer":[]}],"parameters":[{"name":"searchId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}}],"responses":{"200":{"description":"Server-Sent Events stream","content":{"text/event-stream":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}},"x-toolset":"search","x-safety":"read","x-tenancy":"public"}},"/v1/search/{searchId}/results":{"get":{"operationId":"searchResults","tags":["search"],"summary":"Search results","description":"Stored results of a search by tab (all / new / history / auction) and / or result group (obtainable / taken / unknown, e.g. the collapsed taken group), in result order; keyset cursor; page size capped by the plan rowsPerPage (guests 25).","security":[{},{"bearer":[]}],"parameters":[{"name":"searchId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}},{"name":"tab","in":"query","required":false,"schema":{"type":"string","enum":["all","new","history","auction"]}},{"name":"group","in":"query","required":false,"schema":{"type":"string","enum":["obtainable","taken","unknown"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","required":["domain","unicode","zone","name","length","status","offers","metrics"],"properties":{"domain":{"type":"string"},"unicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"length":{"type":"integer"},"status":{"type":"string","enum":["available","auction","dropping","expiring","buy_now","taken","unknown"]},"statusAsOf":{"type":["string","null"]},"offers":{"type":"array","items":{"type":"object","required":["id","kind","provider","price"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"minNextBid":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"bids":{"type":"integer"},"endsAt":{"type":["string","null"]},"termsUrl":{"type":"string"}}}},"metrics":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"value":{"type":["number","null"]},"asOf":{"type":["string","null"]}},"required":["value","asOf"]}},"otherZones":{"type":"array","items":{"type":"string"}},"topic":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}},"coreTop":{"type":"string"},"enrolledTier":{"type":["integer","null"]},"watched":{"type":"boolean"},"wished":{"type":"boolean"},"freshness":{"type":"string","enum":["fresh","aging","stale"]},"refreshing":{"type":"boolean"},"group":{"type":"string","enum":["obtainable","taken","unknown"]},"droppedAt":{"type":["string","null"]}}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}},"x-toolset":"search","x-safety":"read","x-tenancy":"public"}},"/v1/topics/domains":{"post":{"operationId":"topicsDomains","tags":["search"],"summary":"Obtainable domains of a topic by value","description":"Obtainable names (available, dropping, expiring, auction, buy now) in a topic and its subtopics, best value first (history, referring domains, topic fit, how soon obtainable; price-agnostic). topic: id or name. Guests allowed. 1 search of the daily quota.","security":[{},{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"topic":{"type":"string","minLength":1,"maxLength":120},"langs":{"type":"array","items":{"type":"string","minLength":2,"maxLength":8,"pattern":"^[a-z]{2,3}(-[A-Za-z]{2})?$","description":"Language code (ru, en …): history / page language"},"maxItems":10,"description":"History languages of the site (ru, en …)"},"zones":{"type":"array","items":{"type":"string","minLength":1,"maxLength":63},"maxItems":50},"statuses":{"type":"array","items":{"type":"string","enum":["available","dropping","expiring","auction","buy_now"]},"maxItems":5},"limit":{"type":"integer","minimum":1,"maximum":50,"default":20}},"required":["topic"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"topic":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"items":{"type":"array","items":{"type":"object","required":["domain","unicode","zone","name","length","status","offers","metrics"],"properties":{"domain":{"type":"string"},"unicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"length":{"type":"integer"},"status":{"type":"string","enum":["available","auction","dropping","expiring","buy_now","taken","unknown"]},"statusAsOf":{"type":["string","null"]},"offers":{"type":"array","items":{"type":"object","required":["id","kind","provider","price"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"minNextBid":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"bids":{"type":"integer"},"endsAt":{"type":["string","null"]},"termsUrl":{"type":"string"}}}},"metrics":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"value":{"type":["number","null"]},"asOf":{"type":["string","null"]}},"required":["value","asOf"]}},"otherZones":{"type":"array","items":{"type":"string"}},"topic":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}},"coreTop":{"type":"string"},"enrolledTier":{"type":["integer","null"]},"watched":{"type":"boolean"},"wished":{"type":"boolean"},"freshness":{"type":"string","enum":["fresh","aging","stale"]},"refreshing":{"type":"boolean"},"group":{"type":"string","enum":["obtainable","taken","unknown"]},"droppedAt":{"type":["string","null"]}}}},"scores":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"value":{"type":"number"},"reasons":{"type":"array","items":{"type":"string"}}},"required":["domain","value","reasons"]}},"asOf":{"type":"string","format":"date-time"}},"required":["topic","items","scores","asOf"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"}},"x-toolset":"search","x-safety":"read","x-tenancy":"public","x-mcp-tool":"topics_domains"}},"/v1/keywords/search":{"post":{"operationId":"keywordsSearch","tags":["search"],"summary":"Domains whose pages carry keywords","description":"Domains whose pages carry the keywords (word-form tolerant), obtainable first, then taken (for analysis), with the matched keywords and pages. match all = every keyword. Use keywords_suggest first for a free-text request. 1 search of the daily quota.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80},"minItems":1,"maxItems":20},"lang":{"type":"string","minLength":2,"maxLength":8,"pattern":"^[a-z]{2,3}(-[A-Za-z]{2})?$","description":"Language code (ru, en …): history / page language"},"match":{"type":"string","enum":["any","all"],"default":"any"},"obtainableOnly":{"type":"boolean","default":false},"limit":{"type":"integer","minimum":1,"maximum":50,"default":20}},"required":["keywords"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"items":{"type":"array","items":{"type":"object","required":["domain","unicode","zone","name","length","status","offers","metrics"],"properties":{"domain":{"type":"string"},"unicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"length":{"type":"integer"},"status":{"type":"string","enum":["available","auction","dropping","expiring","buy_now","taken","unknown"]},"statusAsOf":{"type":["string","null"]},"offers":{"type":"array","items":{"type":"object","required":["id","kind","provider","price"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"minNextBid":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"bids":{"type":"integer"},"endsAt":{"type":["string","null"]},"termsUrl":{"type":"string"}}}},"metrics":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"value":{"type":["number","null"]},"asOf":{"type":["string","null"]}},"required":["value","asOf"]}},"otherZones":{"type":"array","items":{"type":"string"}},"topic":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}},"coreTop":{"type":"string"},"enrolledTier":{"type":["integer","null"]},"watched":{"type":"boolean"},"wished":{"type":"boolean"},"freshness":{"type":"string","enum":["fresh","aging","stale"]},"refreshing":{"type":"boolean"},"group":{"type":"string","enum":["obtainable","taken","unknown"]},"droppedAt":{"type":["string","null"]}}}},"matches":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"group":{"type":"string","enum":["obtainable","taken","unknown"]},"keywords":{"type":"array","items":{"type":"string"}},"pages":{"type":"array","items":{"type":"string"}},"coverage":{"type":"number"}},"required":["domain","group","keywords","pages","coverage"]}},"groups":{"type":"object","additionalProperties":false,"properties":{"obtainable":{"type":"integer"},"taken":{"type":"integer"},"unknown":{"type":"integer"}},"required":["obtainable","taken","unknown"]},"asOf":{"type":"string","format":"date-time"}},"required":["items","matches","groups","asOf"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"search","x-safety":"read","x-tenancy":"user","x-mcp-tool":"keywords_search"}},"/v1/keywords/suggest":{"post":{"operationId":"keywordsSuggest","tags":["search"],"summary":"Keyword suggestions for a request","description":"Head and long-tail keywords for a free-text request (product, niche), per language: from keywords found on the sites we hold first, then assistant suggestions (source suggested). frequency = relative share; volume only when search-engine statistics are configured. 1 search.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"request":{"type":"string","minLength":1,"maxLength":500},"lang":{"type":"string","minLength":2,"maxLength":8,"pattern":"^[a-z]{2,3}(-[A-Za-z]{2})?$","description":"Language code (ru, en …): history / page language"},"n":{"type":"integer","minimum":1,"maximum":50,"default":20}},"required":["request"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"lang":{"type":"string"},"keywords":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string"},"kind":{"type":"string","enum":["head","long_tail"]},"source":{"type":"string","enum":["data","suggested"]},"domains":{"type":"integer"},"frequency":{"type":"number"},"volume":{"type":["integer","null"]}},"required":["keyword","kind","source","domains","frequency","volume"]}},"volumeSource":{"type":"string","enum":["search_engine","relative"]},"asOf":{"type":"string","format":"date-time"}},"required":["lang","keywords","volumeSource","asOf"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"search","x-safety":"read","x-tenancy":"user","x-mcp-tool":"keywords_suggest"}},"/v1/keywords/volume":{"post":{"operationId":"keywordsVolume","tags":["search"],"summary":"Search volume of keywords (Google / Yandex where configured)","description":"Search volume of up to 50 keywords from our caches: our relative frequency plus cached Google / Yandex monthly searches (30 d) with dates. fresh: true asks the source now (≤ 10 keywords; per-user daily quota): the answer is preliminary, meta.refresh / refresh_wait deliver the fresh value. 1 search.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80},"minItems":1,"maxItems":50},"lang":{"type":"string","minLength":2,"maxLength":8,"pattern":"^[a-z]{2,3}(-[A-Za-z]{2})?$","description":"Language code (ru, en …): history / page language"},"region":{"type":"string","pattern":"^[a-z]{2}$","description":"Country (ru, us …)"},"sources":{"type":"string","enum":["auto","google","yandex"],"default":"auto"},"fresh":{"type":"boolean","default":false,"description":"Ask the source now (through our server); the fresh value arrives via the refresh handle"}},"required":["keywords"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"lang":{"type":"string"},"keywords":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string"},"domains":{"type":"integer"},"frequency":{"type":"number"},"volumes":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string","enum":["google","yandex"]},"monthly":{"type":["integer","null"]},"competition":{"type":["string","null"]},"asOf":{"type":"string","format":"date-time"},"cached":{"type":"boolean"}},"required":["source","monthly","competition","asOf","cached"]}}},"required":["keyword","domains","frequency","volumes"]}},"sources":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string","enum":["google","yandex"]},"status":{"type":"string","enum":["ok","cached","not_configured","test_access","forbidden","quota","error"]},"asOf":{"type":["string","null"],"format":"date-time"}},"required":["source","status","asOf"]}},"asOf":{"type":"string","format":"date-time"},"refreshes":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string"},"source":{"type":"string","enum":["google","yandex"]},"refresh":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"status":{"type":"string"},"kinds":{"type":"array","items":{"type":"string"}},"eta":{"type":["string","null"]},"reason":{"type":"string"}},"required":["id","status","kinds","eta"]}},"required":["keyword","source","refresh"]}}},"required":["lang","keywords","sources","asOf"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"search","x-safety":"read","x-tenancy":"user","x-mcp-tool":"keywords_volume"}},"/v1/competitors/find":{"post":{"operationId":"competitorsFind","tags":["search"],"summary":"Competitors for a topic or keywords","description":"Competitors: registered (taken) sites in a topic and / or carrying the keywords, with their top keywords, topic and link profile (referring domains, linking domains we found). Input for traffic_sources. Taken names are never obtainable. 1 search of the daily quota.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"topic":{"type":"string","minLength":1,"maxLength":120},"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80},"maxItems":20},"lang":{"type":"string","minLength":2,"maxLength":8,"pattern":"^[a-z]{2,3}(-[A-Za-z]{2})?$","description":"Language code (ru, en …): history / page language"},"limit":{"type":"integer","minimum":1,"maximum":25,"default":10}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"topic":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"competitors":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"status":{"type":"string"},"topic":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"keywords":{"type":"array","items":{"type":"string"}},"matched":{"type":"array","items":{"type":"string"}},"referringDomains":{"type":["number","null"]},"linkingDomains":{"type":"integer"}},"required":["domain","status","keywords","matched","referringDomains","linkingDomains"]}},"asOf":{"type":"string","format":"date-time"}},"required":["competitors","asOf"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"search","x-safety":"read","x-tenancy":"user","x-mcp-tool":"competitors_find"}},"/v1/traffic/sources":{"post":{"operationId":"trafficSources","tags":["search"],"summary":"Traffic sources (linking sites) of domains","description":"Traffic sources of up to 10 domains (usually competitors): the sites linking to them in our link graph (top 200 per domain), with status, topic and authority; grouped by topic, plus adjacent topics. Feed the competitors to candidates_from_sources. 1 search.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"domains":{"type":"array","items":{"type":"string","minLength":3,"maxLength":253},"minItems":1,"maxItems":10}},"required":["domains"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"sources":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"target":{"type":"string"},"links":{"type":"integer"},"anchors":{"type":"array","items":{"type":"string"}},"status":{"type":"string"},"group":{"type":"string","enum":["obtainable","taken","unknown"]},"topic":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"authority":{"type":["integer","null"]}},"required":["domain","target","links","anchors","status","group","authority"]}},"byTopic":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"topic":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"count":{"type":"integer"}},"required":["topic","count"]}},"adjacentTopics":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"topic":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"count":{"type":"integer"}},"required":["topic","count"]}},"capped":{"type":"boolean"},"asOf":{"type":"string","format":"date-time"}},"required":["sources","byTopic","adjacentTopics","capped","asOf"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"search","x-safety":"read","x-tenancy":"user","x-mcp-tool":"traffic_sources"}},"/v1/candidates/from-sources":{"post":{"operationId":"candidatesFromSources","tags":["search"],"summary":"Obtainable candidates from competitors' traffic sources","description":"Obtainable names among the sites linking to the competitors and in their adjacent topics, best value first; each item has reasons (links_to_competitor, history, ref_domains, adjacent_topic). notIndexed: competitors without inbound links in our index (meta.notice; a snapshot is requested). 1 search.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"competitors":{"type":"array","items":{"type":"string","minLength":3,"maxLength":253},"minItems":1,"maxItems":10},"langs":{"type":"array","items":{"type":"string","minLength":2,"maxLength":8,"pattern":"^[a-z]{2,3}(-[A-Za-z]{2})?$","description":"Language code (ru, en …): history / page language"},"maxItems":10,"description":"History languages of the site (ru, en …)"},"zones":{"type":"array","items":{"type":"string","minLength":1,"maxLength":63},"maxItems":50},"limit":{"type":"integer","minimum":1,"maximum":50,"default":20}},"required":["competitors"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"items":{"type":"array","items":{"type":"object","required":["domain","unicode","zone","name","length","status","offers","metrics","reasons"],"properties":{"domain":{"type":"string"},"unicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"length":{"type":"integer"},"status":{"type":"string","enum":["available","auction","dropping","expiring","buy_now","taken","unknown"]},"statusAsOf":{"type":["string","null"]},"offers":{"type":"array","items":{"type":"object","required":["id","kind","provider","price"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"minNextBid":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"bids":{"type":"integer"},"endsAt":{"type":["string","null"]},"termsUrl":{"type":"string"}}}},"metrics":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"value":{"type":["number","null"]},"asOf":{"type":["string","null"]}},"required":["value","asOf"]}},"otherZones":{"type":"array","items":{"type":"string"}},"topic":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}},"coreTop":{"type":"string"},"enrolledTier":{"type":["integer","null"]},"watched":{"type":"boolean"},"wished":{"type":"boolean"},"freshness":{"type":"string","enum":["fresh","aging","stale"]},"refreshing":{"type":"boolean"},"group":{"type":"string","enum":["obtainable","taken","unknown"]},"droppedAt":{"type":["string","null"]},"reasons":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["links_to_competitor","adjacent_topic","history","ref_domains"]},"text":{"type":"string"},"competitor":{"type":"string"},"count":{"type":"integer"}},"required":["kind","text"]}}}}},"scores":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"value":{"type":"number"},"reasons":{"type":"array","items":{"type":"string"}}},"required":["domain","value","reasons"]}},"adjacentTopics":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"notIndexed":{"type":"array","items":{"type":"string"}},"collecting":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","skipped"]},"kinds":{"type":"array","items":{"type":"string"}},"eta":{"type":["string","null"]},"reason":{"type":"string"}},"required":["id","status","kinds","eta"]}},"asOf":{"type":"string","format":"date-time"}},"required":["items","scores","adjacentTopics","notIndexed","asOf"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"search","x-safety":"read","x-tenancy":"user","x-mcp-tool":"candidates_from_sources"}},"/v1/domains/{domain}":{"get":{"operationId":"domain","tags":["domains"],"summary":"Domain","description":"Domain details: status (statusAsOf), offers from fresh facts, metrics with asOf, other zones, history, archive, WHOIS, semantic core, topic; watched / wished. A valid name not seen yet: blank card (status unknown, no offers) + meta.refresh that brings availability and register offers. 400 for a malformed name.","security":[{},{"bearer":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":300}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["domain","unicode","zone","name","length","status","offers","metrics"],"properties":{"domain":{"type":"string"},"unicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"length":{"type":"integer"},"status":{"type":"string","enum":["available","auction","dropping","expiring","buy_now","taken","unknown"]},"statusAsOf":{"type":["string","null"]},"offers":{"type":"array","items":{"type":"object","required":["id","kind","provider","price"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"minNextBid":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"bids":{"type":"integer"},"endsAt":{"type":["string","null"]},"termsUrl":{"type":"string"}}}},"metrics":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"value":{"type":["number","null"]},"asOf":{"type":["string","null"]}},"required":["value","asOf"]}},"otherZones":{"type":"array","items":{"type":"string"}},"topic":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}},"coreTop":{"type":"string"},"enrolledTier":{"type":["integer","null"]},"watched":{"type":"boolean"},"wished":{"type":"boolean"},"freshness":{"type":"string","enum":["fresh","aging","stale"]},"refreshing":{"type":"boolean"},"group":{"type":"string","enum":["obtainable","taken","unknown"]},"droppedAt":{"type":["string","null"]},"core":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string"},"volume":{"type":"integer"},"position":{"type":"integer"}},"required":["keyword"]}},"history":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"date":{"type":"string"},"event":{"type":"string","enum":["registered","expired","dropped","transferred","auctioned","sold","site_copied"]},"detail":{"type":"string"}}}},"archive":{"type":"object","additionalProperties":false,"properties":{"firstCapture":{"type":["string","null"]},"lastCapture":{"type":["string","null"]},"snapshotsByYear":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"year":{"type":"integer"},"count":{"type":"integer"}}}},"crawls":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"crawl":{"type":"string"},"year":{"type":"integer"},"pages":{"type":"integer"},"htmlPages":{"type":"integer"},"home":{"type":["string","null"]}},"required":["crawl","year","pages"]}},"crawlFirstSeen":{"type":["string","null"]},"crawlLastSeen":{"type":["string","null"]}}},"linkingPages":{"type":"object","additionalProperties":false,"properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string"},"domain":{"type":"string"},"targetUrl":{"type":"string"},"anchor":{"type":"string"},"nofollow":{"type":"boolean"},"seenAt":{"type":["string","null"]}},"required":["url","domain"]}}},"required":["total","items"]},"whois":{"type":"object","additionalProperties":false,"properties":{"registrar":{"type":["string","null"]},"created":{"type":["string","null"]},"expires":{"type":["string","null"]},"status":{"type":"array","items":{"type":"string"}},"nameservers":{"type":"array","items":{"type":"string"}}}},"topicHistory":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"year":{"type":"integer"},"topic":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}},"change":{"type":"string","enum":["major","minor"]}},"required":["year","topic"]}},"quality":{"type":"object","additionalProperties":false,"properties":{"score":{"type":"integer","minimum":0,"maximum":100},"coverage":{"type":"number","minimum":0,"maximum":1},"passed":{"type":"integer"},"failed":{"type":"integer"},"unknown":{"type":"integer"},"checks":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","enum":["indexed","favicon","archive_pages","referring_sites","no_glue","search_history","free_verified"]},"state":{"type":"string","enum":["pass","fail","unknown"]},"value":{"type":["number","null"]},"threshold":{"type":["number","null"]},"evidence":{"type":"string"},"source":{"type":["string","null"]},"asOf":{"type":["string","null"]},"applicable":{"type":"boolean"}},"required":["id","state","evidence","asOf","applicable"]}},"asOf":{"type":"string"}},"required":["score","coverage","checks","asOf"]},"glue":{"type":"object","additionalProperties":false,"properties":{"glued":{"type":["boolean","null"]},"hosts":{"type":"array","items":{"type":"string"}},"evidence":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["search_index","redirect","canonical","wayback_redirect","wayback_canonical"]},"source":{"type":"string"},"url":{"type":"string"},"target":{"type":"string"},"asOf":{"type":["string","null"]}},"required":["kind","source","url","target","asOf"]}},"checked":{"type":"array","items":{"type":"string","enum":["search_index","redirect","canonical","wayback_redirect","wayback_canonical"]}},"asOf":{"type":["string","null"]}},"required":["glued","hosts","evidence","checked"]},"adsTxt":{"type":"object","additionalProperties":false,"properties":{"present":{"type":["boolean","null"]},"sellers":{"type":"integer"},"direct":{"type":"integer"},"reseller":{"type":"integer"},"systems":{"type":"array","items":{"type":"string"}},"source":{"type":["string","null"]},"asOf":{"type":["string","null"]}},"required":["present","sellers"]},"buyingAdvice":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["backorder","register","none"]},"reasoning":{"type":"string"},"options":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"action":{"type":"string","enum":["backorder","register"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"url":{"type":"string"},"offerId":{"type":"string"},"cheapest":{"type":"boolean"}},"required":["provider","action","url"]}}},"required":["kind","reasoning","options"]}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}},"x-toolset":"domains","x-safety":"read","x-tenancy":"public","x-mcp-tool":"get_domain"}},"/v1/refresh/{id}":{"get":{"operationId":"refreshGet","tags":["domains"],"summary":"Refresh handle: the refined result of a cache-first read (long-poll)","description":"The refined result of a cache-first read: pass meta.refresh.id (MCP: the `refresh.handle` of a tool result). wait=0..25 s blocks until the refresh is done (or the wait ends): status queued / running / done / failed / skipped, the refreshed status and the updated item.","security":[{},{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":25,"default":0}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","skipped"]},"kinds":{"type":"array","items":{"type":"string"}},"eta":{"type":["string","null"]},"reason":{"type":"string"},"subject":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string"},"key":{"type":"string"}},"required":["kind","key"]},"createdAt":{"type":"string"},"finishedAt":{"type":["string","null"]},"result":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["available","auction","dropping","expiring","buy_now","taken","unknown"]},"checkedAt":{"type":"string"},"registered":{"type":["boolean","null"]}},"required":["status","checkedAt"]},"item":{"type":"object","required":["domain","unicode","zone","name","length","status","offers","metrics"],"properties":{"domain":{"type":"string"},"unicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"length":{"type":"integer"},"status":{"type":"string","enum":["available","auction","dropping","expiring","buy_now","taken","unknown"]},"statusAsOf":{"type":["string","null"]},"offers":{"type":"array","items":{"type":"object","required":["id","kind","provider","price"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"minNextBid":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"bids":{"type":"integer"},"endsAt":{"type":["string","null"]},"termsUrl":{"type":"string"}}}},"metrics":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"value":{"type":["number","null"]},"asOf":{"type":["string","null"]}},"required":["value","asOf"]}},"otherZones":{"type":"array","items":{"type":"string"}},"topic":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}},"coreTop":{"type":"string"},"enrolledTier":{"type":["integer","null"]},"watched":{"type":"boolean"},"wished":{"type":"boolean"},"freshness":{"type":"string","enum":["fresh","aging","stale"]},"refreshing":{"type":"boolean"},"group":{"type":"string","enum":["obtainable","taken","unknown"]},"droppedAt":{"type":["string","null"]}}},"volume":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string"},"keyword":{"type":"string"},"lang":{"type":"string"},"region":{"type":"string"},"monthly":{"type":["integer","null"]},"competition":{"type":["string","null"]},"asOf":{"type":"string"}},"required":["source","keyword","monthly","asOf"]},"snapshot":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"source":{"type":"string","enum":["fresh","stored"]},"phase":{"type":"string","enum":["queued","crawling","done","failed"]},"status":{"type":["string","null"],"enum":["ok","unreachable","blocked",null]},"title":{"type":["string","null"]},"lang":{"type":["string","null"]},"topic":{"type":["object","null"],"additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"type":"string"}}},"parked":{"type":["boolean","null"]},"forSale":{"type":["boolean","null"]},"pages":{"type":"integer"},"keywords":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string"},"weight":{"type":"number"}},"required":["keyword","weight"]}},"screenshotUrl":{"type":["string","null"]},"screenshotStatus":{"type":"string","enum":["pending","ok","unreachable","blocked","failed","none"]},"takenAt":{"type":["string","null"]}},"required":["domain","source","phase","status","title","lang","topic","pages","keywords","screenshotUrl","screenshotStatus","takenAt"]}},"required":["id","status","kinds","eta","subject","createdAt","finishedAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}},"x-toolset":"domains","x-safety":"read","x-tenancy":"public","x-mcp-tool":"refresh_wait"}},"/v1/refresh/{id}/events":{"get":{"operationId":"refreshEvents","tags":["domains"],"summary":"Server-sent events of a refresh handle","description":"text/event-stream of a refresh handle: refresh.updated {id, status, item?, snapshot?} on each change (a site snapshot: also as its summary grows), then refresh.done {id, status, item, result, snapshot?} or refresh.failed {id, status, reason} (also after 120 s without a result); then the stream closes.","security":[{},{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}}],"responses":{"200":{"description":"Server-Sent Events stream","content":{"text/event-stream":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}},"x-toolset":"domains","x-safety":"read","x-tenancy":"public"}},"/v1/sites/snapshot":{"post":{"operationId":"siteSnapshot","tags":["domains"],"summary":"Site snapshot: stored now, a fresh one in real time","description":"Site snapshot (home + a few pages: title, language, keywords, topic; screenshot). Answers now with `stored` data; fresh: true (default) takes a fresh one at top priority: `refresh` is its handle (skipped: plan / quota / budget); refresh_wait returns `snapshot` in ~30–60 s. Use when the user asks to look at, refresh or analyse a site now.","security":[{},{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string","minLength":3,"maxLength":253,"description":"The site (domain name)"},"fresh":{"type":"boolean","default":true,"description":"Take a fresh snapshot now (real time; per-plan daily quota)"}},"required":["domain"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"stored":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string"},"source":{"type":"string","enum":["fresh","stored"]},"phase":{"type":"string","enum":["queued","crawling","done","failed"]},"status":{"type":["string","null"],"enum":["ok","unreachable","blocked",null]},"title":{"type":["string","null"]},"lang":{"type":["string","null"]},"topic":{"type":["object","null"],"additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"type":"string"}}},"parked":{"type":["boolean","null"]},"forSale":{"type":["boolean","null"]},"pages":{"type":"integer"},"keywords":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string"},"weight":{"type":"number"}},"required":["keyword","weight"]}},"screenshotUrl":{"type":["string","null"]},"screenshotStatus":{"type":"string","enum":["pending","ok","unreachable","blocked","failed","none"]},"takenAt":{"type":["string","null"]}},"required":["domain","source","phase","status","title","lang","topic","pages","keywords","screenshotUrl","screenshotStatus","takenAt"]},{"type":"null"}]},"asOf":{"type":["string","null"]},"refresh":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed","skipped"]},"kinds":{"type":"array","items":{"type":"string"}},"eta":{"type":["string","null"]},"reason":{"type":"string"}},"required":["id","status","kinds","eta"]}},"required":["domain","stored","asOf"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"}},"x-toolset":"domains","x-safety":"read","x-tenancy":"public","x-mcp-tool":"site_snapshot"}},"/v1/lists":{"get":{"operationId":"listTree","tags":["lists"],"summary":"Workspace list tree with counts (deleted / pending / expiring by zone, auctions by house)","description":"List tree with counts: deleted (available again, with history), pending delete (upcoming drops), expiring — by zone — and live auctions by house. Counts are fresh facts only.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","label","count"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"count":{"type":"integer"},"children":{"type":"array","items":{"type":"object"}}}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"lists","x-safety":"read","x-tenancy":"user"}},"/v1/lists/{listType}/domains":{"get":{"operationId":"listDomains","tags":["lists"],"summary":"List domains","description":"A page of a list (deleted / pending / expiring / auction; one zone or auction house) with SearchFilters and sort (`-backlinks,length`: domain, length, price, endsAt or a metric). Keyset cursor; page size ≤ plan rowsPerPage. Free: TF / CF / volume filters → 402 FEATURE_LOCKED; those metrics are left out.","parameters":[{"name":"listType","in":"path","required":true,"schema":{"type":"string","enum":["deleted","pending","expiring","auction"]}},{"name":"zone","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":63}},{"name":"source","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64}},{"name":"filter","in":"query","required":false,"schema":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string","enum":["all","new","history","auction"]},"historyKinds":{"type":"array","items":{"type":"string","enum":["deleted","pending","expiring"]},"maxItems":3},"zones":{"type":"array","items":{"type":"string","minLength":1,"maxLength":63},"maxItems":200},"lengthMin":{"type":"integer","minimum":0,"maximum":253},"lengthMax":{"type":"integer","minimum":0,"maximum":253},"charset":{"type":"object","additionalProperties":false,"properties":{"letters":{"type":"boolean"},"digits":{"type":"boolean"},"hyphens":{"type":"boolean"}}},"keywordPosition":{"type":"string","enum":["anywhere","starts","ends"]},"ageMin":{"type":"integer","minimum":0},"backlinksMin":{"type":"integer","minimum":0},"referringDomainsMin":{"type":"integer","minimum":0},"archiveFirstYearMax":{"type":"integer","minimum":0},"archiveSnapshotsMin":{"type":"integer","minimum":0},"tfMin":{"type":"integer","minimum":0},"cfMin":{"type":"integer","minimum":0},"otherZonesMin":{"type":"integer","minimum":0},"searchVolumeMin":{"type":"integer","minimum":0},"priceMin":{"type":"number","minimum":0},"priceMax":{"type":"number","minimum":0},"withinDays":{"type":"integer","minimum":0,"maximum":3650},"sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":50},"topics":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":50},"coreKeyword":{"type":"string","maxLength":100},"obtainableOnly":{"type":"boolean"},"languages":{"type":"array","items":{"type":"string","pattern":"^[a-z]{2,3}$"},"maxItems":20}}}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"columns","in":"query","required":false,"schema":{"type":"string","maxLength":500}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1000}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","required":["domain","unicode","zone","name","length","status","offers","metrics"],"properties":{"domain":{"type":"string"},"unicode":{"type":"string"},"zone":{"type":"string"},"name":{"type":"string"},"length":{"type":"integer"},"status":{"type":"string","enum":["available","auction","dropping","expiring","buy_now","taken","unknown"]},"statusAsOf":{"type":["string","null"]},"offers":{"type":"array","items":{"type":"object","required":["id","kind","provider","price"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["register","backorder","bid","buy_now"]},"provider":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"minNextBid":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]},"bids":{"type":"integer"},"endsAt":{"type":["string","null"]},"termsUrl":{"type":"string"}}}},"metrics":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"value":{"type":["number","null"]},"asOf":{"type":["string","null"]}},"required":["value","asOf"]}},"otherZones":{"type":"array","items":{"type":"string"}},"topic":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"meta":{"type":"string"},"crawledAt":{"type":["string","null"]},"parentId":{"type":["string","null"]},"tier":{"type":"integer","minimum":1,"maximum":4},"path":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"secondary":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["id","name","score"]}}}},"coreTop":{"type":"string"},"enrolledTier":{"type":["integer","null"]},"watched":{"type":"boolean"},"wished":{"type":"boolean"},"freshness":{"type":"string","enum":["fresh","aging","stale"]},"refreshing":{"type":"boolean"},"group":{"type":"string","enum":["obtainable","taken","unknown"]},"droppedAt":{"type":["string","null"]}}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"lists","x-safety":"read","x-tenancy":"user","x-mcp-tool":"list_domains"}},"/v1/exports":{"post":{"operationId":"exportList","tags":["lists"],"summary":"Export list","description":"Exports a list (listType deleted / pending / expiring / auction with zone + filter, or watchlist:<id> / search:<id>) as CSV or JSON through a job. Plan feature export (402 FEATURE_LOCKED); rows count against exportRowsPerDay (402 PLAN_LIMIT_REACHED when none are left; an export is capped at the rows left).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"listType":{"type":"string","minLength":1,"maxLength":100},"zone":{"type":"string","minLength":1,"maxLength":63},"filter":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string","enum":["all","new","history","auction"]},"historyKinds":{"type":"array","items":{"type":"string","enum":["deleted","pending","expiring"]},"maxItems":3},"zones":{"type":"array","items":{"type":"string","minLength":1,"maxLength":63},"maxItems":200},"lengthMin":{"type":"integer","minimum":0,"maximum":253},"lengthMax":{"type":"integer","minimum":0,"maximum":253},"charset":{"type":"object","additionalProperties":false,"properties":{"letters":{"type":"boolean"},"digits":{"type":"boolean"},"hyphens":{"type":"boolean"}}},"keywordPosition":{"type":"string","enum":["anywhere","starts","ends"]},"ageMin":{"type":"integer","minimum":0},"backlinksMin":{"type":"integer","minimum":0},"referringDomainsMin":{"type":"integer","minimum":0},"archiveFirstYearMax":{"type":"integer","minimum":0},"archiveSnapshotsMin":{"type":"integer","minimum":0},"tfMin":{"type":"integer","minimum":0},"cfMin":{"type":"integer","minimum":0},"otherZonesMin":{"type":"integer","minimum":0},"searchVolumeMin":{"type":"integer","minimum":0},"priceMin":{"type":"number","minimum":0},"priceMax":{"type":"number","minimum":0},"withinDays":{"type":"integer","minimum":0,"maximum":3650},"sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":50},"topics":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":50},"coreKeyword":{"type":"string","maxLength":100},"obtainableOnly":{"type":"boolean"},"languages":{"type":"array","items":{"type":"string","pattern":"^[a-z]{2,3}$"},"maxItems":20}}},"format":{"type":"string","enum":["csv","json"]}},"required":["listType","format"]}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed"]},"url":{"type":["string","null"]},"rows":{"type":"integer"}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"lists","x-safety":"write","x-tenancy":"user"}},"/v1/exports/{id}":{"get":{"operationId":"exportJob","tags":["lists"],"summary":"Export job","description":"Export status; when done, `url` is a signed download link valid for 15 minutes (ask again for a new one).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed"]},"url":{"type":["string","null"]},"rows":{"type":"integer"}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"lists","x-safety":"read","x-tenancy":"user"}},"/v1/exports/{id}/download":{"get":{"operationId":"exportDownload","tags":["lists"],"summary":"Download an export (signed link)","description":"Downloads an export file through its signed link (from exportJob.url; expires after 15 minutes). No bearer: the signature authorizes.","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"expires","in":"query","required":true,"schema":{"type":"integer","minimum":0}},{"name":"sig","in":"query","required":true,"schema":{"type":"string","minLength":10,"maxLength":200}}],"responses":{"200":{"description":"Raw bytes","content":{"application/octet-stream":{"schema":{"type":"string","contentEncoding":"binary"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"}},"x-toolset":"lists","x-safety":"read","x-tenancy":"public"}},"/v1/agent/answers":{"post":{"operationId":"agentAnswer","tags":["agent"],"summary":"One-shot answer for a free-text search (guests allowed within quota); SSE like messages","description":"Answer to a free-text search (read-only tools); SSE as sendMessage. done {answerToken}: send it as answerToken to continue (guests too; stale → 404) or to startConversation after sign-in (1 h). Each turn counts 1 search + 1 assistant message; tool searches inside it are free. Either quota used up → 402 PLAN_LIMIT_REACHED (resetAt, upgradePlanId). 503 NOT_CONFIGURED without an assistant.","security":[{},{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"text":{"type":"string","minLength":1,"maxLength":2000},"filters":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string","enum":["all","new","history","auction"]},"historyKinds":{"type":"array","items":{"type":"string","enum":["deleted","pending","expiring"]},"maxItems":3},"zones":{"type":"array","items":{"type":"string","minLength":1,"maxLength":63},"maxItems":200},"lengthMin":{"type":"integer","minimum":0,"maximum":253},"lengthMax":{"type":"integer","minimum":0,"maximum":253},"charset":{"type":"object","additionalProperties":false,"properties":{"letters":{"type":"boolean"},"digits":{"type":"boolean"},"hyphens":{"type":"boolean"}}},"keywordPosition":{"type":"string","enum":["anywhere","starts","ends"]},"ageMin":{"type":"integer","minimum":0},"backlinksMin":{"type":"integer","minimum":0},"referringDomainsMin":{"type":"integer","minimum":0},"archiveFirstYearMax":{"type":"integer","minimum":0},"archiveSnapshotsMin":{"type":"integer","minimum":0},"tfMin":{"type":"integer","minimum":0},"cfMin":{"type":"integer","minimum":0},"otherZonesMin":{"type":"integer","minimum":0},"searchVolumeMin":{"type":"integer","minimum":0},"priceMin":{"type":"number","minimum":0},"priceMax":{"type":"number","minimum":0},"withinDays":{"type":"integer","minimum":0,"maximum":3650},"sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":50},"topics":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":50},"coreKeyword":{"type":"string","maxLength":100},"obtainableOnly":{"type":"boolean"},"languages":{"type":"array","items":{"type":"string","pattern":"^[a-z]{2,3}$"},"maxItems":20}}},"answerToken":{"type":"string","minLength":1,"maxLength":200},"strategy":{"type":"string","enum":["auto","targeted_traffic","brand","seo_power","resale","general"]},"surface":{"type":"string","enum":["search","domain","lists","orders"]}},"required":["text"]}}}},"responses":{"200":{"description":"Server-Sent Events stream","content":{"text/event-stream":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"}},"x-toolset":"agent","x-safety":"write","x-tenancy":"public"}},"/v1/agent/conversations":{"post":{"operationId":"startConversation","tags":["agent"],"summary":"Start conversation","description":"Starts a conversation with the assistant (personal, or the team's with X-Team-Id). With the `answerToken` of an agentAnswer `done` event (1 hour, single use; a guest's answer may be claimed by whoever signs in, otherwise by the same owner) the conversation starts with that question and answer; `seeded` tells whether it did. 503 NOT_CONFIGURED without an assistant backend.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"answerToken":{"type":"string","minLength":1,"maxLength":200}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"seeded":{"type":"boolean"}},"required":["id"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"agent","x-safety":"write","x-tenancy":"user"}},"/v1/agent/conversations/{id}/messages":{"post":{"operationId":"sendMessage","tags":["agent"],"summary":"Send message","description":"The assistant answers as a stream, acting through dropexpired tools under the caller's policy, plan and team role: lists, names, wishes, alerts (change events, undo 10 min via agentUndo), order previews (proposal). Max 12 tool steps. SSE: strategy, text.delta, tool.*, change, proposal, memory, items, done, error. Each turn counts 1 search + 1 message (tool searches free); used up → 402 (resetAt).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"text":{"type":"string","minLength":1,"maxLength":4000},"strategy":{"type":"string","enum":["auto","targeted_traffic","brand","seo_power","resale","general"]},"context":{"type":"object","additionalProperties":false,"properties":{"route":{"type":"string","maxLength":500},"selection":{"type":"array","items":{"type":"string","maxLength":300},"maxItems":200},"surface":{"type":"string","enum":["search","domain","lists","orders"]}}}},"required":["text"]}}}},"responses":{"200":{"description":"Server-Sent Events stream","content":{"text/event-stream":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"agent","x-safety":"write","x-tenancy":"user"}},"/v1/agent/undo":{"post":{"operationId":"agentUndo","tags":["agent"],"summary":"Agent undo","description":"Undoes a change the assistant made (the undoToken of a `change` event) within 10 minutes; later or unknown → 410 UNDO_EXPIRED.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"undoToken":{"type":"string","minLength":1,"maxLength":200}},"required":["undoToken"]}}}},"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"agent","x-safety":"write","x-tenancy":"user"}},"/v1/agent/feedback":{"post":{"operationId":"agentFeedback","tags":["agent"],"summary":"Rate an assistant answer","description":"Feedback on a completed answer (the turnId of its `done` event): rating up / down (none / null clears), reasons (inaccurate, not_relevant, too_slow, other), a short text (PII-scrubbed). Changeable; omitted fields keep their value. A guest's answer: whoever holds the turnId; otherwise the same owner (else 404). Counts against no quota; bursts → 429.","security":[{},{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"turnId":{"type":"string","minLength":1,"maxLength":64},"rating":{"type":["string","null"],"enum":["up","down","none",null]},"reasons":{"type":"array","items":{"type":"string","enum":["inaccurate","not_relevant","too_slow","other"]},"maxItems":4},"text":{"type":["string","null"],"maxLength":2000}},"required":["turnId"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"turnId":{"type":"string"},"rating":{"type":["string","null"],"enum":["up","down",null]},"reasons":{"type":"array","items":{"type":"string"}},"text":{"type":["string","null"]}},"required":["turnId","rating","reasons","text"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"}},"x-toolset":"agent","x-safety":"write","x-tenancy":"public"}},"/v1/me/agent-memory":{"get":{"operationId":"agentMemory","tags":["me"],"summary":"Remembered assistant preferences","description":"What the assistant remembers about you (history languages, topics, zones, budget, notes), with when and how it was saved. Used only for your answers, never for AI training; deleted with the account.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"key":{"type":"string","enum":["languages","topics","zones","budget","notes"]},"value":{"type":"array","items":{"type":"string"}},"source":{"type":"string","enum":["user","agent"]},"updatedAt":{"type":"string","format":"date-time"}},"required":["key","value","source","updatedAt"]}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"read","x-tenancy":"user"}},"/v1/me/agent-memory/{key}":{"put":{"operationId":"setAgentMemory","tags":["me"],"summary":"Set a remembered preference","description":"Sets a remembered preference (replaces its values; an empty list deletes it). source: user (edited in Settings, default) or agent (the user confirmed the assistant's `memory` proposal).","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","enum":["languages","topics","zones","budget","notes"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":20},"source":{"type":"string","enum":["user","agent"]}},"required":["value"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"key":{"type":"string","enum":["languages","topics","zones","budget","notes"]},"value":{"type":"array","items":{"type":"string"}},"source":{"type":"string","enum":["user","agent"]},"updatedAt":{"type":"string","format":"date-time"}},"required":["key","value","source","updatedAt"]},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"write","x-tenancy":"user"},"delete":{"operationId":"deleteAgentMemory","tags":["me"],"summary":"Delete a remembered preference","description":"Deletes a remembered preference; key `all` deletes everything the assistant remembers about you.","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","enum":["languages","topics","zones","budget","notes","all"]}}],"responses":{"204":{"description":"No content"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"x-toolset":"me","x-safety":"write","x-tenancy":"user"}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Access JWT (apps), customer API key `dx_live_…` or service key `dx_live_…` (service clients)."}},"schemas":{"Meta":{"type":"object","required":["requestId"],"properties":{"requestId":{"type":"string"},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]},"total":{"type":"integer"}}},"usage":{"type":"object","description":"Usage of the limit this call counted against","properties":{"limit":{"type":"string"},"used":{"type":"integer"},"max":{"type":["integer","null"]}}}}},"ErrorEnvelope":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","ACCOUNT_EXISTS","SPENDING_LIMIT_EXCEEDED","OFFER_GONE","PREVIEW_EXPIRED","UNDO_EXPIRED","PLAN_LIMIT_REACHED","FEATURE_LOCKED","PROVIDER_ACCOUNT_REQUIRED","PROVIDER_ERROR","PROVIDER_AUTH","RATE_LIMITED","INTERNAL","ROLE_REQUIRED","NOT_A_MEMBER","INVITATION_INVALID","NOT_IMPLEMENTED","NOT_CONFIGURED","CONFLICT","CONFIRMATION_REQUIRED","UNAVAILABLE","INVALID_PROMO"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":true}},"requestId":{"type":"string"}}}}}},"responses":{"Error":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}