Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Affinda Workspaces API

Workspaces group together related collections, documents, members, and webhook subscriptions. Workspace identifiers scope every document upload, listing, and webhook delivery. Includes per-workspace usage reporting for credits and pages processed.

Affinda Workspaces API is one of 16 APIs that Affinda publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Workspaces, Organization, and Permissions. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

This API exposes 10 operations across 5 paths, and defines 35 schemas. It is described by OpenAPI 3.0.3, at version 3.0.0.

Requests are made against a single base URL, https://{region}.affinda.com.

10 operations 5 paths 35 schemas 2 DELETE5 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
3.0.0
Server
https://{region}.affinda.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Affinda Workspaces API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — Basic authentication using an API key, e.g. {Authorization: Bearer aff0bb4fbdf97b7e4111ff6c0015471094155f91}. You can find your API key within the Settings pag…

Paths & Operations 10

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

Workspaces 10

Operations to manage workspaces. Workspaces group together related collections of documents.

GET
/v3/workspaces
Get list of all workspaces
getAllWorkspaces 2 params → 200400401default
POST
/v3/workspaces
Create a workspace
createWorkspace body → 201400401default
GET
/v3/workspaces/{identifier}
Get specific workspace
getWorkspace 1 param → 200400401default
PATCH
/v3/workspaces/{identifier}
Update a workspace
updateWorkspace 1 param body → 200400401default
DELETE
/v3/workspaces/{identifier}
Delete a workspace
deleteWorkspace 1 param → 204400401default
GET
/v3/workspaces/{identifier}/usagedeprecated
Get usage by workspace
getUsageByWorkspace 3 params → 200400401default
GET
/v3/workspace_memberships
Get list of all workspace memberships
getAllWorkspaceMemberships 4 params → 200400401default
POST
/v3/workspace_memberships
Create a workspace membership
createWorkspaceMembership body → 201400401default
GET
/v3/workspace_memberships/{identifier}
Get specific workspace membership
getWorkspaceMembership 1 param → 200400401default
DELETE
/v3/workspace_memberships/{identifier}
Delete a workspace membership
deleteWorkspaceMembership 1 param → 204400401default

Schemas 35

The contract defines 35 schemas that model the data the API accepts and returns. The most detailed are Workspace (14 properties), WorkspaceCreate (8 properties), Organization (8 properties), WorkspaceUpdate (7 properties). Each schema is shown below with its type and property counts.

ThemeConfig
object
4 properties
RequestError
object
2 properties 2 required
UsageByWorkspace
object
Monthly credits consumption
2 properties 2 required
DocumentSplitter_properties-identifier
string
Uniquely identify a document splitter.
baseExtractor
object
6 properties 4 required
WorkspaceMembership
object
3 properties
WorkspaceUpdate
object
7 properties
WorkspaceCreate
object
8 properties 2 required
properties-id
integer
Uniquely identify a user.
createdDt
string
PaginatedResponse
object
3 properties 1 required
Organization_properties-identifier
string
Uniquely identify an organization.
category
string
UsageByWorkspaceResponse
array
Monthly credits consumption
identifier
string
Uniquely identify a workspace.
whitelistIngestAddresses
array
If specified, only emails from these addresses will be ingested for parsing. Wild cards are allowed, e.g. "@eyefind.info".
properties-identifier
string
Uniquely identify a collection.
namePlural
string
rejectInvalidDocuments
boolean
If true, the uploaded document will be rejected if it's of the wrong document type, or if its document type cannot be determined. No credits will be consumed.
OrganizationRole
string
Workspace
object
14 properties 1 required
WorkspaceVisibility
string
Visibility "organization" means everyone in the organization can access the workspace. Visibility "private" means only people explicitly added can access the w…
confirmedDocsCount
integer
Number of validated documents in the collection.
name
string
WorkspaceMembership_properties-identifier
string
Uniquely identify a membership.
User
object
5 properties
validatable
boolean
unvalidatedDocsCount
integer
Number of unvalidated documents in the collection.
RejectDuplicates
boolean
If "true", parsing will fail when the uploaded document is duplicate of an existing document, no credits will be consumed. If "false", will parse the document…
Extractor_properties-identifier
string
Uniquely identify an extractor.
Organization
object
8 properties
PaletteColorOptions
object
4 properties 1 required
isCustom
boolean
WorkspaceMembershipCreate
object
2 properties
WorkspaceDocumentSplitter
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

affinda-workspaces-api-openapi.yml Raw ↑

Other APIs Affinda publishes across the network.

Affinda Documents API
Affinda Document Types API
Affinda Organizations API
Affinda Data Sources API
Affinda Annotations API
Affinda Validation Results API
Affinda Tags API
Affinda Usage API
Affinda Webhooks API
Affinda Search and Match API
Affinda Add x-hidden to endpoints API
Affinda Deprecated End Points API