aVenture APIEntity Maintenance

Set entity status

View as Markdown
Updates one or more entity visibility and editorial status flags. Omitted flags are left unchanged.

Authentication

AuthorizationBearer

User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key

OR
X-API-Keystring

Admin API key for system-to-system write operations

Path parameters

entityIdstringRequiredformat: "uuid"
Canonical entity UUID

Query parameters

sourceTypeenumRequired
Write provenance source type.
sourceDetailstringRequired
Source detail or reviewer reference for the write.
sourceProviderstringOptional

Provider name for provider-native IDs or slugs.

sourceProviderIdstringOptional

Provider-native source ID.

sourceProviderSlugstringOptional

Provider-native source slug.

actorTypeenumOptional

Actor type; inferred as agent when agentChassis and agentModel are supplied, or as employee from an authenticated user JWT session.

Allowed values:
agentChassisstringOptional

Agent chassis token for agent-authored writes.

agentModelstringOptional

Agent model id for agent-authored writes.

overrideGateenumOptional
Gate to override from the prior ProblemDetail resolution.
overrideReasonstringOptional0-2048 characters

Source-backed reason for overriding the returned gate requirement.

Request

This endpoint expects an object.
isFeaturedboolean or nullOptional
Set whether this entity is editorially featured
isHiddenboolean or nullOptional
Set whether this entity is hidden from public list and detail views. Create default is true when omitted.
isVerifiedboolean or nullOptional
Set whether this entity has passed editorial verification
showOnSitemapboolean or nullOptional
Set whether this entity is included in the public sitemap. Create default is false when omitted.

Response

OK
isFeaturedboolean
Whether this entity is editorially featured
isHiddenboolean
Whether this entity is hidden from public list and detail views
isVerifiedboolean
Whether this entity has passed editorial verification
showOnSitemapboolean
Whether this entity is included in the public sitemap

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
406
Not Acceptable Error
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error