> ## Documentation Index > Fetch the complete documentation index at: https://docs.devtune.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update a domain > Changes one thing about a tracked domain per request: brandId moves it to another brand of this project (null unassigns it), domainType tags it, or siteType sets how Audit scores one of the primary brand's domains. Only domains added to a brand can be tagged or given a site type; others return 409. A domain outside this project returns 404. Requires the setup.write scope. ## OpenAPI ````yaml /openapi.json patch /projects/{projectId}/setup/domains/{domainId} openapi: 3.1.0 info: title: DevTune API version: 2.0.0 description: >- API for programmatic access to your AI visibility data, webhook subscriptions, and automation workflows. Use this API to integrate DevTune data into CI/CD pipelines, BI tools, AI agents, and operational systems. servers: - url: https://devtune.ai/api/v2 description: Production security: - bearerAuth: [] paths: /projects/{projectId}/setup/domains/{domainId}: patch: summary: Update a domain description: >- Changes one thing about a tracked domain per request: brandId moves it to another brand of this project (null unassigns it), domainType tags it, or siteType sets how Audit scores one of the primary brand's domains. Only domains added to a brand can be tagged or given a site type; others return 409. A domain outside this project returns 404. Requires the setup.write scope. operationId: updateDomain parameters: - name: projectId in: path required: true schema: type: string format: uuid - name: domainId in: path required: true description: A domain id from listDomains. schema: type: string format: uuid requestBody: required: true content: application/json: schema: description: >- Exactly one of brandId, domainType or siteType, beside the path domainId. oneOf: - type: object additionalProperties: false required: - brandId properties: brandId: type: - string - 'null' format: uuid - type: object additionalProperties: false required: - domainType properties: domainType: type: string enum: - docs - github - blog - package - home - other - type: object additionalProperties: false required: - siteType properties: siteType: type: string enum: - content - api_application responses: '200': description: The updated domain content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/SetupDomainWrite' meta: $ref: '#/components/schemas/Meta' required: - data - meta '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '403': $ref: '#/components/responses/ForbiddenError' '404': $ref: '#/components/responses/NotFoundError' '409': $ref: '#/components/responses/ConflictError' '429': $ref: '#/components/responses/RateLimitExceededError' components: schemas: SetupDomainWrite: type: object additionalProperties: false required: - domain properties: domain: $ref: '#/components/schemas/SetupDomain' Meta: type: object properties: timestamp: type: string format: date-time projectId: type: string format: uuid SetupDomain: type: object additionalProperties: false required: - id - domain - brandId - category - domainType - siteType - createdAt - updatedAt properties: id: type: string format: uuid domain: type: string description: The tracked domain, with a path when one was given. brandId: type: - string - 'null' description: The brand the domain belongs to; null when unassigned. category: type: string enum: - primary - secondary - other description: primary for the project's own brand, secondary for a competitor's. domainType: type: string description: The domain tag. siteType: type: - string - 'null' enum: - content - api_application - null description: How Audit scores one of the primary brand's domains. createdAt: type: string format: date-time updatedAt: type: string format: date-time Error: type: object properties: error: type: string message: type: string reason: type: string description: >- Why the request was refused, for an error with more than one cause, such as a refused content-draft start. details: type: object additionalProperties: true description: >- Machine-readable facts about the refusal, such as shortfall_credits when an Agent Picks start is refused for insufficient_credits. status: type: integer required: - error - message - status responses: BadRequestError: description: Bad request content: application/json: schema: $ref: '#/components/schemas/Error' UnauthorizedError: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' ForbiddenError: description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error' NotFoundError: description: Not found content: application/json: schema: $ref: '#/components/schemas/Error' ConflictError: description: Request conflicts with current resource state content: application/json: schema: $ref: '#/components/schemas/Error' RateLimitExceededError: description: Rate limit exceeded headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' headers: X-RateLimit-Limit: description: Maximum requests per window schema: type: integer X-RateLimit-Remaining: description: Requests remaining in current window schema: type: integer X-RateLimit-Reset: description: Unix timestamp when the window resets schema: type: integer securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.