SEDNA Category Tag API API
The Category Tag API API from SEDNA — 7 operation(s) for category tag api.
The Category Tag API API from SEDNA — 7 operation(s) for category tag api.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/sedna-category-tag-api-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
contact:
name: Support
url: https://support.sedna.com
termsOfService: https://www.sedna.com/terms-of-service
title: Sedna Authentication Category Tag API
version: '2019-01-01'
servers:
- description: Platform endpoint
url: https://{tenant}.sednanetwork.com/platform
variables:
tenant:
default: example
description: Your tenant's unique identifier
security:
- Basic: []
- OAuth: []
tags:
- name: Category Tag API
paths:
/2019-01-01/category-tag:
post:
description: 'Create a category tag
Required API Permissions: CATEGORYTAG_WRITE'
operationId: createCategoryTag
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CategoryTagCreate'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/CategoryTagCreate'
responses:
default:
content:
application/json:
schema:
$ref: '#/components/schemas/CategoryTagSingle'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/CategoryTagSingle'
description: default response
tags:
- Category Tag API
get:
description: 'Fetch a collection of category tags
Required API Permissions: CATEGORYTAG_READ'
operationId: getCategoryTags
parameters:
- in: query
name: page[limit]
schema:
type: integer
format: int64
default: 100
- in: query
name: page[offset]
schema:
type: integer
format: int64
default: 0
- description: Filter results by name containing given value. Case-insensitive.
in: query
name: filter[name]
schema:
type: string
default: ''
responses:
default:
content:
application/json:
schema:
$ref: '#/components/schemas/CategoryTagCollection'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/CategoryTagCollection'
description: default response
tags:
- Category Tag API
/2019-01-01/category-tag/{id}:
delete:
description: 'Delete a category tag
Required API Permissions: CATEGORYTAG_DELETE'
operationId: deleteCategoryTag
parameters:
- in: path
name: id
required: true
schema:
type: integer
format: int64
responses:
default:
content:
application/json: {}
application/vnd.api+json: {}
description: default response
tags:
- Category Tag API
get:
description: 'Fetch a category tag
Required API Permissions: CATEGORYTAG_READ'
operationId: getCategoryTag
parameters:
- in: path
name: id
required: true
schema:
type: integer
format: int64
responses:
default:
content:
application/json:
schema:
$ref: '#/components/schemas/CategoryTagSingle'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/CategoryTagSingle'
description: default response
tags:
- Category Tag API
patch:
description: 'Update a category tag
Required API Permissions: CATEGORYTAG_WRITE'
operationId: updateCategoryTag
parameters:
- in: path
name: id
required: true
schema:
type: integer
format: int64
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CategoryTagUpdate'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/CategoryTagUpdate'
responses:
default:
content:
application/json:
schema:
$ref: '#/components/schemas/CategoryTagSingle'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/CategoryTagSingle'
description: default response
tags:
- Category Tag API
/2019-01-01/category-tag/{id}/message:
get:
description: 'Fetch a collection of messages that have the given category tag applied. DEPRECATED: please use /{id}/messageV2 instead
Required API Permissions: CATEGORYTAG_READ, MESSAGE_READ'
operationId: getMessagesWithCategoryTag
parameters:
- in: path
name: id
required: true
schema:
type: integer
format: int64
- in: query
name: page[limit]
schema:
type: integer
format: int64
default: 100
maximum: 100
- in: query
name: page[offset]
schema:
type: integer
format: int64
default: 0
- description: 'Comma separated list of fields to return. Please include only necessary fields for performance reasons. If this parameter is omitted, API will return all the fields and it can negatively impact the latency. Available fields: subject,snippet,fromName,fromEmail,bodyText,bodyHtml,hasAttachment,receivedAt,sentAt,messageId,inReplyTo,references,from,to,cc,bcc,signed. Id is always returned.'
in: query
name: fields[message]
schema:
type: string
- in: query
name: filter
schema:
type: string
- in: query
name: include
schema:
type: string
responses:
default:
content:
application/json:
schema:
$ref: '#/components/schemas/MessageCollection'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/MessageCollection'
description: default response
tags:
- Category Tag API
/2019-01-01/category-tag/{id}/messageV2:
get:
description: 'Fetch a collection of messages that have the given category tag applied
Required API Permissions: CATEGORYTAG_READ, MESSAGE_READ'
operationId: getMessagesWithCategoryTagV2
parameters:
- in: path
name: id
required: true
schema:
type: integer
format: int64
- description: the next-page cursor returned as part of a previous call to this endpoint
in: query
name: page[cursor]
schema:
type: string
- in: query
name: page[limit]
schema:
type: integer
format: int64
default: 100
maximum: 100
- description: 'Comma separated list of fields to return. Please include only necessary fields for performance reasons. If this parameter is omitted, API will return all the fields and it can negatively impact the latency. Available fields: subject,snippet,fromName,fromEmail,bodyText,bodyHtml,hasAttachment,receivedAt,sentAt,messageId,inReplyTo,references,from,to,cc,bcc,signed. Id is always returned.'
in: query
name: fields[message]
schema:
type: string
- in: query
name: filter
schema:
type: string
- description: Comma separated list of teams to filter by. Only returns messages that belong to any of the specified teams. If omitted, messages belonging to all teams, including solo inboxes, are returned.
in: query
name: filter[team]
schema:
type: string
- description: The value to sort the message by. Must be one of 'received_date' or 'activity'. Defaults to 'received_date' if not specified.
in: query
name: sort
schema:
type: string
default: received_date
- description: The order in which to sort the messages, i.e. 'desc' (newest messages first) or 'asc' (oldest messages first). Defaults to 'desc' if not specified.
in: query
name: order
schema:
type: string
default: desc
- description: Array of comma-separated relationships to retrieve entities for if they are present in the retrieved messages' relationships. e.g. 'comment,document,share,team,category,job_reference,assignment,keyword,address'
in: query
name: include
schema:
type: string
responses:
default:
content:
application/json:
schema:
$ref: '#/components/schemas/WithNextPageCursorMessageCollection'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/WithNextPageCursorMessageCollection'
description: default response
tags:
- Category Tag API
/2019-01-01/category-tag/{id}/relationships/message:
post:
description: 'Add messages to a category tag''s message relationships
Required API Permissions: CATEGORYTAG_WRITE'
operationId: addCategoryTagToMessages
parameters:
- in: path
name: id
required: true
schema:
type: integer
format: int64
- in: query
name: page[limit]
schema:
type: integer
format: int64
default: 1000
maximum: 1000
- in: query
name: page[offset]
schema:
type: integer
format: int64
default: 0
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateMessageRelToMany'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/UpdateMessageRelToMany'
responses:
default:
content:
application/json:
schema:
$ref: '#/components/schemas/MessageRelToMany'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/MessageRelToMany'
description: default response
tags:
- Category Tag API
get:
description: 'Fetch a category tag''s message relationships. DEPRECATED: please use /{id}/messageV2 instead
Required API Permissions: CATEGORYTAG_READ'
operationId: getCategoryTagMessageRelationships
parameters:
- in: query
name: page[limit]
schema:
type: integer
format: int64
default: 100
- in: query
name: page[offset]
schema:
type: integer
format: int64
default: 0
- in: path
name: id
required: true
schema:
type: integer
format: int64
responses:
default:
content:
application/json:
schema:
$ref: '#/components/schemas/MessageRelGetToMany'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/MessageRelGetToMany'
description: default response
tags:
- Category Tag API
delete:
description: 'Remove messages from a category tag''s message relationships
Required API Permissions: CATEGORYTAG_WRITE'
operationId: removeCategoryTagFromMessages
parameters:
- in: path
name: id
required: true
schema:
type: integer
format: int64
- in: query
name: page[limit]
schema:
type: integer
format: int64
default: 1000
maximum: 1000
- in: query
name: page[offset]
schema:
type: integer
format: int64
default: 0
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateMessageRelToMany'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/UpdateMessageRelToMany'
responses:
default:
content:
application/json:
schema:
$ref: '#/components/schemas/MessageRelToMany'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/MessageRelToMany'
description: default response
tags:
- Category Tag API
/2019-01-01/category-tag/{id}/relationships/team:
post:
description: 'Add teams to a category tag''s team relationships, adds to relationships only
Required API Permissions: CATEGORYTAG_WRITE'
operationId: addCategoryTagTeams
parameters:
- in: path
name: id
required: true
schema:
type: integer
format: int64
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateTeamRelToMany'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/UpdateTeamRelToMany'
responses:
default:
content:
application/json: {}
application/vnd.api+json: {}
description: default response
tags:
- Category Tag API
delete:
description: 'Remove teams from a category tag''s team relationships, removes relationships only
Required API Permissions: CATEGORYTAG_DELETE'
operationId: deleteCategoryTagTeams
parameters:
- in: path
name: id
required: true
schema:
type: integer
format: int64
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateTeamRelToMany'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/UpdateTeamRelToMany'
responses:
default:
content:
application/json: {}
application/vnd.api+json: {}
description: default response
tags:
- Category Tag API
get:
description: 'Fetch a category tag''s team relationships
Required API Permissions: CATEGORYTAG_READ'
operationId: getCategoryTagTeamRelationships
parameters:
- in: path
name: id
required: true
schema:
type: integer
format: int64
responses:
default:
content:
application/json:
schema:
$ref: '#/components/schemas/TeamRelToMany'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/TeamRelToMany'
description: default response
tags:
- Category Tag API
patch:
description: 'Replace all teams in a category tag''s team relationships, partial update not supported
Required API Permissions: CATEGORYTAG_WRITE'
operationId: replaceCategoryTagTeams
parameters:
- in: path
name: id
required: true
schema:
type: integer
format: int64
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateTeamRelToMany'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/UpdateTeamRelToMany'
responses:
default:
content:
application/json: {}
application/vnd.api+json: {}
description: default response
tags:
- Category Tag API
/2019-01-01/category-tag/{id}/team:
get:
description: 'Fetch a category tag''s related teams
Required API Permissions: CATEGORYTAG_READ, TEAM_READ'
operationId: getCategoryTagTeams
parameters:
- in: path
name: id
required: true
schema:
type: integer
format: int64
responses:
default:
content:
application/json:
schema:
$ref: '#/components/schemas/TeamCollection'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/TeamCollection'
description: default response
tags:
- Category Tag API
components:
schemas:
TeamRelLinks:
type: object
properties:
related:
type: string
self:
type: string
MessageCollectionLinks:
type: object
properties:
first:
type: string
next:
type: string
self:
type: string
MessageCollection:
type: object
description: The resource
properties:
data:
type: array
items:
$ref: '#/components/schemas/MessageReadResource'
included:
type: array
items:
type: object
links:
$ref: '#/components/schemas/MessageCollectionLinks'
meta:
$ref: '#/components/schemas/MessageCollectionMeta'
TeamRelToMany:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/TeamRelData'
links:
$ref: '#/components/schemas/TeamRelLinks'
MessageMeta:
type: object
properties:
download:
type: string
DocumentRelLinks:
type: object
properties:
related:
type: string
self:
type: string
UpdateTeamRelToMany:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/TeamRelData'
JobReferenceRelLinks:
type: object
properties:
related:
type: string
self:
type: string
CategoryTagCreateResource:
type: object
properties:
attributes:
$ref: '#/components/schemas/CategoryTagCreateAttributes'
relationships:
$ref: '#/components/schemas/CategoryTagCreateRelationships'
type:
type: string
TeamLinks:
type: object
properties:
self:
type: string
DocumentRelToMany:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/DocumentRelData'
links:
$ref: '#/components/schemas/DocumentRelLinks'
TeamAttributes:
type: object
properties:
additionalEmailAddresses:
type: array
items:
type: string
archived:
type: boolean
autoBccEmails:
type: array
items:
$ref: '#/components/schemas/TeamAttributeAutoBccEmail'
createdAt:
type: string
format: date-time
disableSend:
type: boolean
emailAddress:
type: string
emailSignature:
type: string
foreignKey:
type: string
inboxAssignedToUserId:
type: string
internalEmailAddress:
type: string
name:
type: string
public:
type: boolean
purpose:
type: string
sendingName:
type: string
soloInbox:
type: boolean
TeamAttributeAutoBccEmail:
type: object
properties:
email:
type: string
name:
type: string
required:
- email
MessageRelData:
type: object
properties:
id:
type: string
type:
type: string
TagName:
type: object
properties:
value:
type: string
ResourceObjectIdentifier:
type: object
properties:
id:
type: string
meta:
$ref: '#/components/schemas/MetaObject'
type:
type: string
CategoryTagSingleLinks:
type: object
properties:
self:
type: string
CategoryTagCollection:
type: object
description: A collection of resources
properties:
data:
type: array
items:
$ref: '#/components/schemas/CategoryTagResource'
links:
$ref: '#/components/schemas/CategoryTagCollectionLinks'
CategoryTagCreateRelationships:
type: object
properties:
team:
$ref: '#/components/schemas/UpdateTeamRelToMany'
CategoryTagRelToMany:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/CategoryTagRelData'
links:
$ref: '#/components/schemas/CategoryTagRelLinks'
MessageReadAttributes:
type: object
properties:
bcc:
type: array
items:
type: string
bodyHtml:
type: string
bodyText:
type: string
cc:
type: array
items:
type: string
from:
type: array
items:
type: string
fromEmail:
type: string
fromName:
type: string
hasAttachment:
type: boolean
inReplyTo:
type: string
messageId:
type: string
quarantineStatus:
type: string
receivedAt:
type: string
format: date-time
references:
type: string
sentAt:
type: string
format: date-time
signed:
type: string
enum:
- UNVERIFIED
- UNSIGNED
- VERIFIED
- FAILED_VERIFICATION
snippet:
type: string
subject:
type: string
to:
type: array
items:
type: string
TeamCollectionLinks:
type: object
properties:
first:
type: string
next:
type: string
self:
type: string
MessageCollectionMeta:
type: object
properties:
count:
type: integer
format: int32
CategoryTagUpdate:
type: object
properties:
data:
$ref: '#/components/schemas/CategoryTagUpdateResource'
JobReferenceRelData:
type: object
properties:
id:
type: string
messageTag:
$ref: '#/components/schemas/MessageTag'
type:
type: string
TeamRelationships:
type: object
properties:
categoryTag:
$ref: '#/components/schemas/CategoryTagRelToMany'
user:
$ref: '#/components/schemas/UserRelToMany'
WithNextPageCursorMessageCollection:
type: object
properties:
nextPageCursor:
type: string
response:
$ref: '#/components/schemas/MessageCollection'
Sender:
type: object
properties:
data:
$ref: '#/components/schemas/ResourceObjectIdentifier'
meta:
$ref: '#/components/schemas/MetaObject'
PrivateLabelRelLinks:
type: object
properties:
related:
type: string
self:
type: string
MessageRelationships:
type: object
properties:
category-tag:
$ref: '#/components/schemas/CategoryTagRelToMany'
document:
$ref: '#/components/schemas/DocumentRelToMany'
job-reference:
$ref: '#/components/schemas/JobReferenceRelToMany'
message_thread_summary:
$ref: '#/components/schemas/MessageThreadSummary'
private-label:
$ref: '#/components/schemas/PrivateLabelRelToMany'
sender:
$ref: '#/components/schemas/Sender'
team:
$ref: '#/components/schemas/TeamRelToMany'
TagLabel:
type: object
properties:
value:
type: string
UserRelLinks:
type: object
properties:
related:
type: string
self:
type: string
MessageTag:
type: object
properties:
assignedToUserId:
type: string
createdAt:
type: string
format: date-time
eventId:
$ref: '#/components/schemas/EventId'
messageId:
type: string
messageTagId:
$ref: '#/components/schemas/MessageTagId'
removedAt:
type: string
format: date-time
removedByUserId:
type: string
tag:
$ref: '#/components/schemas/Tag'
tagId:
$ref: '#/components/schemas/TagId'
userId:
type: string
MessageRelLinks:
type: object
properties:
related:
type: string
self:
type: string
MessageTagId:
type: object
properties:
id:
type: integer
format: int64
CategoryTagRelationships:
type: object
properties:
team:
$ref: '#/components/schemas/TeamRelToMany'
TeamRelData:
type: object
properties:
id:
type: string
type:
type: string
CategoryTagCollectionLinks:
type: object
properties:
first:
type: string
next:
type: string
self:
type: string
CategoryTagResource:
type: object
properties:
attributes:
$ref: '#/components/schemas/CategoryTagAttributes'
id:
type: string
links:
$ref: '#/components/schemas/CategoryTagLinks'
relationships:
$ref: '#/components/schemas/CategoryTagRelationships'
type:
type: string
description: the type of the resource
enum:
- category-tag
MessageRelGetData:
type: object
properties:
id:
type: string
type:
type: string
TeamResource:
type: object
properties:
attributes:
$ref: '#/components/schemas/TeamAttributes'
id:
type: string
links:
$ref: '#/components/schemas/TeamLinks'
relationships:
$ref: '#/components/schemas/TeamRelationships'
type:
type: string
description: the type of the resource
enum:
- team
uuid:
type: string
CategoryTagUpdateResource:
type: object
properties:
attributes:
$ref: '#/components/schemas/CategoryTagUpdateAttributes'
type:
type: string
CategoryTagAttributes:
type: object
properties:
archived:
type: boolean
disableFollow:
type: boolean
label:
type: string
name:
type: string
JobReferenceRelToMany:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/JobReferenceRelData'
links:
$ref: '#/components/schemas/JobReferenceRelLinks'
MessageReadResource:
type: object
properties:
attributes:
$ref: '#/components/schemas/MessageReadAttributes'
id:
type: string
links:
$ref: '#/components/schemas/MessageLinks'
meta:
$ref: '#/components/schemas/MessageMeta'
relationships:
$ref: '#/components/schemas/MessageRelationships'
type:
type: string
CategoryTagSingle:
type: object
description: The resource
properties:
data:
$ref: '#/components/schemas/CategoryTagResource'
links:
$ref: '#/components/schemas/CategoryTagSingleLinks'
TagId:
type: object
properties:
id:
type: integer
format: int64
CategoryTagCreateAttributes:
type: object
properties:
archived:
type: boolean
disableFollow:
type: boolean
label:
type: string
name:
type: string
required:
- label
- name
Tag:
type: object
properties:
id:
$ref: '#/components/schemas/TagId'
name:
$ref: '#/components/schemas/TagName'
tagLabel:
$ref: '#/components/schemas/TagLabel'
tagTypeId:
type: integer
format: int32
MessageRelToMany:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/MessageRelData'
links:
$ref: '#/components/schemas/MessageRelLinks'
EventId:
type: object
properties:
id:
type: integer
format: int64
CategoryTagRelData:
type: object
properties:
id:
type: string
messageTag:
$ref: '#/components/schemas/MessageTag'
type:
type: string
DocumentRelData:
type: object
properties:
id:
type: string
type:
type: string
PrivateLabelRelToMany:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/PrivateLabelRelData'
links:
$ref: '#/components/schemas/PrivateLabelRelLinks'
CategoryTagLinks:
type: object
properties:
self:
type: string
TeamCollection:
type: object
description: A collection of resources
properties:
data:
type: array
items:
$ref: '#/components/schemas/TeamResource'
links:
$ref: '#/components/schemas/TeamCollectionLinks'
UserRelToMany:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/UserRelData'
links:
$ref: '#/components/schemas/UserRelLinks'
UserRelData:
type: object
properties:
id:
type: string
type:
type: string
CategoryTagUpdateAttributes:
type: object
properties:
archived:
type: boolean
disableFollow:
type: boolean
label:
type: string
name:
type: string
MessageRelUpdateData:
type: object
properties:
id:
type: string
type:
type: string
MetaObject:
type: object
CategoryTagRelLinks:
type: object
properties:
related:
type: string
self:
type: string
MessageThreadSummary:
type: object
properties:
data:
$ref: '#/components/schemas/ResourceObjectIdentifier'
MessageRelGetToMany:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/MessageRelGetData'
links:
$ref: '#/components/schemas/MessageRelLinks'
PrivateLabelRelData:
type: object
properties:
id:
type: string
type:
type: string
UpdateMessageRelToMany:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/MessageRelUpdateData'
MessageLinks:
type: object
properties:
self:
type: string
CategoryTagCreate:
type: object
properties:
data:
$ref: '#/components/schemas/CategoryTagCreateResource'
securitySchemes:
Basic:
description: The basic auth scheme only requires the API-Specific username/password to be set.
scheme: basic
type: http
OAuth:
description: This API prefers OAuth 2 with client credentials flow. You can create your credentials in the <a href='https://{tenant}.sednanetwork.com/platform/settings/api-credential-management'>Api Credential Management page</a>.
flows:
clientCredentials:
scopes:
CATEGORYTAG_DELETE: Delete category tags
CATEGORYTAG_READ: Read category tags
CATEGORYTAG_WRITE: Create and update category tags
CHARTERING_DELETE: Delete chartering (Pulse) information
CHARTERING_READ: Read chartering (Pulse) information
CHARTERING_WRITE: Create chartering (Pulse) information
COMMENT_READ: Read message comments
COMPANY_READ: Read company info
COMPANY_WRITE: Update company info (eg. signature)
CONTACTGROUP_DELETE: D
# --- truncated at 32 KB (34 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sedna/refs/heads/main/openapi/sedna-category-tag-api-api-openapi.yml