How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Sift Stack Annotation Service API

Service to programmatically interact with annotations.

Sift Stack Annotation Service API is one of 47 APIs that Sift Stack publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include AnnotationService. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

This API exposes 10 operations across 7 paths, and defines 30 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://api.siftstack.com, https://gov.api.siftstack.com.

10 operations 7 paths 30 schemas 1 DELETE2 GET1 PATCH6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.siftstack.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Sift Stack Annotation Service API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). By default, every request must be authenticated.

Paths & Operations 10

Across 7 paths, the API surfaces 10 operations — 1 DELETE, 2 GET, 1 PATCH, 6 POST. Each is listed below with its method, path, parameters, and response codes.

AnnotationService 10

Service to programmatically interact with annotations.

GET
/api/v1/annotations
ListAnnotation
AnnotationService_ListAnnotations 5 params → 200default
POST
/api/v1/annotations
CreateAnnotation
AnnotationService_CreateAnnotation body → 200default
PATCH
/api/v1/annotations
UpdateAnnotation
AnnotationService_UpdateAnnotation body → 200default
GET
/api/v1/annotations/{annotationId}
GetAnnotation
AnnotationService_GetAnnotation 1 param → 200default
DELETE
/api/v1/annotations/{annotationId}
DeleteAnnotation
AnnotationService_DeleteAnnotation 1 param → 200default
POST
/api/v1/annotations/{annotationId}:archive
ArchiveAnnotation
AnnotationService_ArchiveAnnotation 1 param body → 200default
POST
/api/v1/annotations/{annotationId}:unarchive
UnarchiveAnnotation
AnnotationService_UnarchiveAnnotation 1 param body → 200default
POST
/api/v1/annotations:batchArchive
BatchArchiveAnnotations
AnnotationService_BatchArchiveAnnotations body → 200default
POST
/api/v1/annotations:batchDelete
BatchDeleteAnnotation
AnnotationService_BatchDeleteAnnotations body → 200default
POST
/api/v1/annotations:batchUnarchive
BatchUnarchiveAnnotations
AnnotationService_BatchUnarchiveAnnotations body → 200default

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are annotationsv1Annotation (29 properties), v1CreateAnnotationRequest (16 properties), v1MetadataValue (7 properties), v1MetadataKey (4 properties). Each schema is shown below with its type and property counts.

protobufAny
object
Any contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message. Protobuf library provides supp…
1 property
v1BatchArchiveAnnotationsRequest
object
The request for a call to AnnotationServiceBatchArchiveAnnotations.
1 property 1 required
v1BatchArchiveAnnotationsResponse
object
The response of a call to AnnotationServiceBatchArchiveAnnotations.
1 property 1 required
v1BatchUnarchiveAnnotationsResponse
object
The response of a call to AnnotationServiceBatchUnarchiveAnnotations.
1 property 1 required
v1MetadataValue
object
7 properties 1 required
v1AnnotationLinkedCalculatedChannel
object
1 property 1 required
annotationsv1Annotation
object
29 properties 14 required
v1BatchDeleteAnnotationsRequest
object
1 property 1 required
v1DeleteAnnotationResponse
object
The response of a call to AnnotationServiceDeleteAnnotation.
v1UnarchiveAnnotationResponse
object
The response of a call to AnnotationServiceUnarchiveAnnotation.
1 property 1 required
v1UpdateAnnotationRequest
object
The request for a call to AnnotationServiceUpdateAnnotation to update an annotation.
2 properties 2 required
v1AnnotationLinkedChannelsBitFieldElement
object
2 properties 2 required
v1BatchUnarchiveAnnotationsRequest
object
The request for a call to AnnotationServiceBatchUnarchiveAnnotations.
1 property 1 required
v1ListAnnotationsResponse
object
The result of a call to AnnotationServiceListAnnotations.
2 properties
v1AnnotationLinkedChannelsChannel
object
1 property 1 required
v1AnnotationState
string
v1AnnotationType
string
v1GetAnnotationResponse
object
The response of a call to AnnotationServiceGetAnnotation.
1 property 1 required
v1MetadataRelationValue
object
2 properties 2 required
v1MetadataKeyType
string
Metadata key type. - METADATAKEYTYPESTRING: string - METADATAKEYTYPENUMBER: number - METADATAKEYTYPEBOOLEAN: boolean - METADATAKEYTYPERELATION: relation — refe…
v1CreateAnnotationRequest
object
The request for a call to AnnotationServiceCreateAnnotation to create a new annotation. At least 1 asset, tag, or channel must be specified.
16 properties 3 required
v1CreateAnnotationResponse
object
The result of a call to AnnotationServiceCreateAnnotation.
1 property 1 required
rpcStatus
object
3 properties
v1Organization
object
3 properties 2 required
v1MetadataKey
object
4 properties 2 required
v1User
object
3 properties 2 required
v1ArchiveAnnotationResponse
object
The response of a call to AnnotationServiceArchiveAnnotation.
1 property 1 required
v1UpdateAnnotationResponse
object
The response of a call to AnnotationServiceUpdateAnnotation.
1 property
v1BatchDeleteAnnotationsResponse
object
v1AnnotationLinkedChannel
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

sift-stack-annotationservice-api-openapi.yml Raw ↑

Other APIs Sift Stack publishes across the network.

Sift gRPC API
Sift MCP Server
Sift Stack Annotation Log Service API
Sift Stack API Key Service API
Sift Stack Asset Service API
Sift Stack Automation Service API
Sift Stack Calculated Channel Service API
Sift Stack Calculated Channels Service API
Sift Stack Campaign Service API
Sift Stack Channel Schema Service API
Sift Stack Channel Service API
Sift Stack Comment Service API
Where this information came from

This is an independent, third-party profile of Sift Stack Annotation Service API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.