Keystone Developers
Open Keystone
API reference

Edits API

Business claims

1 endpoint.

PUT/api/v1/edits/businesses/{business_id}/claim

Claim a business nobody holds, for 24 hours

The console's claim, for the business picker in Claude too: keystone-mcp passes a claim on only with the card token of the growth partner's click on that card, never on the model's say-so.

Parameters

NameInTypeDescription
business_idrequiredpathstring (uuid)
authorizationheaderstring | null
X-Internal-Api-Keyheaderstring | null

Responses

200Successful Response
application/jsonSuccessResponse_ClaimStateData_
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredClaimStateData
ClaimStateData fields
FieldTypeDescription
business_idrequiredstring
claimClaimData | null
ClaimData fields
FieldTypeDescription
business_idrequiredstring
holder_idrequiredstring
holder_namestring | null
claimed_atrequiredstring (date-time)
expires_atrequiredstring (date-time)
extendedrequiredboolean
minerequiredboolean
launchedrequiredboolean
can_claimrequiredboolean
can_extendrequiredboolean
server_timerequiredstring (date-time)
metadataResponseMetadata | null
ResponseMetadata fields
FieldTypeDescription
paginationPaginationMetadata | null
PaginationMetadata fields
FieldTypeDescription
limitrequiredinteger
next_cursorstring | null
prev_cursorstring | null
has_morerequiredboolean
has_prevbooleandefault false
total_countinteger | null
status_countsobject | null
object | null fields

Map of string to integer

lifecycle_countsLifecycleCounts | null
LifecycleCounts fields
FieldTypeDescription
leadintegerdefault 0
prospectintegerdefault 0
customerintegerdefault 0
former_customerintegerdefault 0
classification_countsClassificationCounts | null
ClassificationCounts fields
FieldTypeDescription
signalobject
object fields

Nested object (not expanded)

touchobject
object fields

Nested object (not expanded)

stageobject
object fields

Nested object (not expanded)

metaResponseMeta | null
ResponseMeta fields
FieldTypeDescription
totalinteger | null
total_countinteger | null
pageinteger | null
per_pageinteger | null
  • 400Bad request
  • 401Unauthorized
  • 403Forbidden
  • 404Not found
  • 422Validation error
  • 500Internal server error
  • 503Service unavailable

Error bodies: ErrorResponse. See Errors.