DomainsResume Domain

Resume Domain

Resume a paused domain (brand) so that its prompts are analyzed again. Its active prompts use prompt credits again.

curl --request POST \
  --url https://api.aiclicks.io/api/v1/domains/resume \
  --header 'Authorization: Bearer ak_live_xxx' \
  --header 'Content-Type: application/json' \
  --data '{"domain_id": "8f1d3c0a-2f9b-4c11-9b80-7a82e1f0c3f3"}'
{
  "data": {
    "message": "Domain resumed successfully",
    "domain_id": "8f1d3c0a-2f9b-4c11-9b80-7a82e1f0c3f3",
    "disabled": false,
    "prompts_refunded": null,
    "remaining_prompts": 4
  },
  "generated_at": "2026-11-17T08:31:40.431563+00:00"
}

Resumes a paused domain. The next analysis runs include the domain again. Each active prompt of the domain uses one prompt credit of the team. To pause a domain, use POST /api/v1/domains/pause.

If the domain is already active, the call changes nothing and returns "Domain is already active". To see if a domain is paused, read the paused field of GET /api/v1/domains.

The team must have one free prompt credit for each active prompt of the domain. If not, the call returns 400 and the domain stays paused. Check the credits first with GET /api/v1/team-usage.

Authorizations

header
Authorizationstring
Required

Your API key in the format Bearer ak_live_<your-key>. Create a key in the dashboard under Settings → Developers. The key must have access to the team that owns domain_id.

header
Content-Typestring
Required

Must be application/json.

Body parameters

body
domain_idstring
Required

UUID of the paused domain. Find it with GET /api/v1/domains.

Response

data.messagestring
Required

Domain resumed successfully, or Domain is already active when the call changed nothing.

data.domain_idstring
Required

UUID of the domain.

data.disabledboolean
Required

Always false. The domain is active.

data.prompts_refundedinteger

Always null for this endpoint.

data.remaining_promptsinteger

The prompt credits of the team after the resume. null when the domain was already active.

generated_atstring
Required

ISO-8601 time when the server made this response.

Side effects

  • The domain is in the next analysis runs again.
  • The team uses one prompt credit for each active prompt of the domain.
  • The API clears the cache of GET /api/v1/domains.

Errors

400 Bad Requesterror

The team does not have enough prompt credits for the active prompts of the domain. Or the subscription of the team is paused. The domain stays paused.

401 Unauthorizederror

The API key is missing, malformed or revoked.

403 Forbiddenerror

The caller is not a member of the team of the domain. Or the API key has no access to this domain. Or the plan of the team does not include API access.

422 Unprocessable Entityerror

The body is not valid. For example, domain_id is missing.

429 Too Many Requestserror

You sent too many requests. Read the Retry-After header to know how long to wait.