> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sentfrom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Refresh a claim link

> Create a new private claim link for a still-active unclaimed account.

Requires the agent-onboarding API release. See [Set up your agent](/agent-install)
for credential handling, safe retries and the human claim flow.


## OpenAPI

````yaml POST /account/claim-link
openapi: 3.1.0
info:
  title: SentFromAI API
  version: 0.1.0
  description: >-
    Comms infrastructure for AI agents. Email send/receive, threading,
    attachments, drafts, webhooks, realtime, and search.
servers:
  - url: https://api.sentfrom.ai/v1
security:
  - bearerAuth: []
tags:
  - name: account
    description: >-
      Agent bootstrap and human ownership claim status; signup requires the
      staged rollout to be enabled.
  - name: inboxes
  - name: messages
  - name: threads
  - name: drafts
  - name: webhooks
  - name: labels
  - name: lists
  - name: attachments
  - name: domains
    description: Custom sending domains
paths:
  /account/claim-link:
    post:
      tags:
        - account
      summary: Refresh the private claim link
      description: >-
        Requires the existing API key and a still-active unclaimed account. Does
        not rotate the API key or extend account lifetime. Claim tokens are
        separate from API keys. Keep the response private and give the URL only
        to the actual operator in an existing trusted chat.
      operationId: refreshAccountClaimLink
      responses:
        '200':
          description: New private claim link.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClaimLink'
        '401':
          description: Missing, invalid or revoked API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OnboardingError'
        '403':
          description: >-
            account_suspended or unclaimed_account_expired: account cannot
            perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OnboardingError'
        '404':
          description: account_not_found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OnboardingError'
        '409':
          description: 'already_claimed: this account already has an owner.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OnboardingError'
        '410':
          description: 'account_expired: the unclaimed account expired.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OnboardingError'
        '429':
          description: >-
            Rate limited. Respect Retry-After before retrying; never create
            another signup identity to avoid a limit.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OnboardingError'
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
                minimum: 1
        '503':
          description: 'signup_unavailable: claim-link cryptography is not configured.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OnboardingError'
components:
  schemas:
    ClaimLink:
      type: object
      properties:
        claim_url:
          type: string
          format: uri
          description: >-
            Private console claim URL, with a separate bearer secret in the
            #token fragment. Share only with the operator in an existing trusted
            channel; never log or email it.
        claim_expires_at:
          type: string
          format: date-time
          description: >-
            Link expiry, default 30 minutes, bounded by account expiry. A new
            link does not extend account lifetime.
      required:
        - claim_url
        - claim_expires_at
    OnboardingError:
      type: object
      properties:
        error:
          type: string
          description: Machine-readable error code.
        message:
          type: string
          description: Explanation and recovery guidance.
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.