Twine Integrations

Twine Integrations API

Twine Integrations API as documented publicly: 13 operations. Contract generated from the documentation by API Evangelist (2026-10-19); not the provider's own document.

Documentation GitHub OpenAPI

Operations 13

POST /v1/org Create the organization #

GET /v1/org/conditions Filtering and ordering #

POST /v1/org/domain-mappings Create a domain mapping #

POST /v1/org/domain-mappings/{domainMappingId}/sync-triggers/{syncTriggerId}/fire Fire a sync trigger #

GET /v1/org/employees Filtering and ordering #

POST /v1/org/employees/shape Filtering and ordering #

GET /v1/org/jobs/{jobId} Get sync job status #

POST /v1/org/system-integrations Create a system integration #

PATCH /v1/org/system-integrations/{id} Update an integration (change credentials or endpoint) #

PUT /v1/org/system-integrations/{id} Deprecated full update of a system integration #

POST /v1/org/system-integrations/{id}/credentials-link Send a credentials link to the customer #

GET /v1/org/time-reports Filtering and ordering #

GET /v1/systems Lookup system ids #

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/twine/refs/heads/main/openapi/_ae-authored/twine-openapi-generated.yml

Schemas & Data

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/twine/refs/heads/main/json-schema/twine-post-v1-org-system-integrations-request-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/twine/refs/heads/main/json-schema/twine-post-v1-org-domain-mappings-request-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/twine/refs/heads/main/json-schema/twine-patch-v1-org-system-integrations-id-request-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/twine/refs/heads/main/json-schema/twine-put-v1-org-system-integrations-id-request-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/twine/refs/heads/main/json-schema/twine-post-v1-org-response-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/twine/refs/heads/main/json-schema/twine-get-v1-org-jobs-jobid-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/twine:twine-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: Twine Integrations API
  version: '2026-10-19'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-19: 13 operation(s) read from 9 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Twine Integrations has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 13
    pages-with-code: 0
    pages-read: 9
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-19'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.twine.se/api-reference/provisioning.md
  - https://docs.twine.se/api-reference/jobs/get-jobs.md
  - https://docs.twine.se/api-reference/users/get-users.md
  - https://docs.twine.se/api-reference/jobs/get-job-by-id.md
  - https://docs.twine.se/api-reference/systems/get-systems.md
  - https://docs.twine.se/api-reference/employees/get-employee.md
  - https://docs.twine.se/api-reference/employees/put-employee.md
  - https://docs.twine.se/api-reference/filtering-and-ordering.md
  - https://docs.twine.se/api-reference/employees/get-employees.md
servers:
- url: https://api.twine.se
paths:
  /v1/org:
    post:
      operationId: post_v1_org
      tags:
      - Org
      summary: Create the organization
      x-source: https://docs.twine.se/api-reference/provisioning.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1OrgRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1OrgResponse'
      x-evidence:
        kind: documentation
  /v1/org/conditions:
    get:
      operationId: get_v1_org_conditions
      tags:
      - Org
      summary: Filtering and ordering
      x-source: https://docs.twine.se/api-reference/filtering-and-ordering.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/org/domain-mappings:
    post:
      operationId: post_v1_org_domain_mappings
      tags:
      - Org
      summary: Create a domain mapping
      x-source: https://docs.twine.se/api-reference/provisioning.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1OrgDomainMappingsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1OrgDomainMappingsResponse'
      x-evidence:
        kind: documentation
  /v1/org/domain-mappings/{domainMappingId}/sync-triggers/{syncTriggerId}/fire:
    post:
      operationId: post_v1_org_domain_mappings_domainMappingId_sync_triggers_syncTriggerId_fire
      tags:
      - Org
      summary: Fire a sync trigger
      x-source: https://docs.twine.se/api-reference/provisioning.md
      parameters:
      - name: domainMappingId
        in: path
        required: true
        schema:
          type: string
      - name: syncTriggerId
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1OrgDomainMappingsDomainmappingidSyncTriggersSynctrigge'
      x-evidence:
        kind: documentation
  /v1/org/employees:
    get:
      operationId: get_v1_org_employees
      tags:
      - Org
      summary: Filtering and ordering
      x-source: https://docs.twine.se/api-reference/filtering-and-ordering.md
      parameters:
      - name: filters
        in: query
        required: false
        schema:
          type: string
        description: Filter object using deepObject style, e.g. filters[updated_at][op]=gt&filters[updated_at][value]=2022-01-01T00:00:00Z
      - name: order
        in: query
        required: false
        schema:
          type: string
        description: Ordering object using deepObject style, e.g. order[field]=updated_at&order[direction]=desc
      - name: pagination
        in: query
        required: false
        schema:
          type: string
        description: Pagination object using deepObject style, e.g. pagination[first]=50
      - name: condition_id
        in: query
        required: false
        schema:
          type: string
        description: ID of an organization‑wide condition to filter the list
      - name: relations
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated list of relation names, e.g. employee_mappings,organizational_unit_mappings
      - name: select
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated list of fields to select, e.g. properties.first_name,properties.email1
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/org/employees/shape:
    post:
      operationId: post_v1_org_employees_shape
      tags:
      - Org
      summary: Filtering and ordering
      x-source: https://docs.twine.se/api-reference/filtering-and-ordering.md
      parameters:
      - name: condition_id
        in: query
        required: false
        schema:
          type: string
        description: ID of an organization‑wide condition to filter the list before shaping
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/org/jobs/{jobId}:
    get:
      operationId: get_v1_org_jobs_jobId
      tags:
      - Org
      summary: Get sync job status
      x-source: https://docs.twine.se/api-reference/provisioning.md
      parameters:
      - name: jobId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1OrgJobsJobidResponse'
      x-evidence:
        kind: documentation
  /v1/org/system-integrations:
    post:
      operationId: post_v1_org_system_integrations
      tags:
      - Org
      summary: Create a system integration
      x-source: https://docs.twine.se/api-reference/provisioning.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1OrgSystemIntegrationsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1OrgSystemIntegrationsResponse'
      x-evidence:
        kind: documentation
  /v1/org/system-integrations/{id}:
    patch:
      operationId: patch_v1_org_system_integrations_id
      tags:
      - Org
      summary: Update an integration (change credentials or endpoint)
      x-source: https://docs.twine.se/api-reference/provisioning.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchV1OrgSystemIntegrationsIdRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_v1_org_system_integrations_id
      tags:
      - Org
      summary: Deprecated full update of a system integration
      x-source: https://docs.twine.se/api-reference/provisioning.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutV1OrgSystemIntegrationsIdRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/org/system-integrations/{id}/credentials-link:
    post:
      operationId: post_v1_org_system_integrations_id_credentials_link
      tags:
      - Org
      summary: Send a credentials link to the customer
      x-source: https://docs.twine.se/api-reference/provisioning.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1OrgSystemIntegrationsIdCredentialsLinkResponse'
      x-evidence:
        kind: documentation
  /v1/org/time-reports:
    get:
      operationId: get_v1_org_time_reports
      tags:
      - Org
      summary: Filtering and ordering
      x-source: https://docs.twine.se/api-reference/filtering-and-ordering.md
      parameters:
      - name: filters
        in: query
        required: false
        schema:
          type: string
        description: Filter object using deepObject style; supports the `in` operator for employee_id, e.g. filters[employee_id][op]=in&filters[employee_id][value]=<uuid>,<uuid>
      - name: order
        in: query
        required: false
        schema:
          type: string
        description: Ordering object using deepObject style
      - name: pagination
        in: query
        required: false
        schema:
          type: string
        description: Pagination object using deepObject style
      - name: condition_id
        in: query
        required: false
        schema:
          type: string
        description: ID of an organization‑wide condition to filter the list
      - name: relations
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated list of relation names
      - name: select
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated list of fields to select
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/systems:
    get:
      operationId: get_v1_systems
      tags:
      - Systems
      summary: Lookup system ids
      x-source: https://docs.twine.se/api-reference/provisioning.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1SystemsResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostV1OrgRequest:
      type: object
      properties:
        name:
          type: string
        vat:
          type: string
        roles:
          type: string
      required:
      - name
    PostV1OrgResponse:
      type: object
      properties:
        roles[].tokens[].jwt:
          type: string
          description: Refresh token JWT
        roles[].tokens[].jti:
          type: string
          description: Refresh token JTI
    PostV1OrgDomainMappingsRequest:
      type: object
      properties:
        source_system_integration_id:
          type: string
        target_system_integration_id:
          type: string
        from_domain:
          type: string
        to_domain:
          type: string
        sync_triggers:
          type: string
        sync_triggers[].cron_expression:
          type: string
        sync_triggers[].enabled:
          type: string
      required:
      - source_system_integration_id
      - target_system_integration_id
      - from_domain
      - to_domain
    PostV1OrgDomainMappingsResponse:
      type: object
      properties:
        id:
          type: string
          description: Domain mapping identifier
    PostV1OrgDomainMappingsDomainmappingidSyncTriggersSynctrigge:
      type: object
      properties:
        job_id:
          type: string
          description: Identifier of the sync job
    GetV1OrgJobsJobidResponse:
      type: object
      properties:
        status:
          type: string
          description: Current status of the job
        result:
          type: string
          description: Result details if completed
    PostV1OrgSystemIntegrationsRequest:
      type: object
      properties:
        system_id:
          type: string
        description:
          type: string
        auth:
          type: string
        auth.slug:
          type: string
        auth.api_client_id:
          type: string
        auth.api_client_secret:
          type: string
        auth.api_endpoint_url:
          type: string
        system_custom:
          type: string
        system_custom.slug:
          type: string
        create_default_mappings:
          type: string
        template_id:
          type: string
      required:
      - system_id
    PostV1OrgSystemIntegrationsResponse:
      type: object
      properties:
        id:
          type: string
          description: Integration identifier
    PatchV1OrgSystemIntegrationsIdRequest:
      type: object
      properties:
        description:
          type: string
        auth:
          type: string
        auth.api_endpoint_url:
          type: string
        auth.api_client_id:
          type: string
        auth.api_client_secret:
          type: string
        system_custom:
          type: string
        system_custom.host:
          type: string
    PutV1OrgSystemIntegrationsIdRequest:
      type: object
      properties:
        system_id:
          type: string
        description:
          type: string
        auth:
          type: string
        system_custom:
          type: string
      required:
      - system_id
      - auth
      - system_custom
    PostV1OrgSystemIntegrationsIdCredentialsLinkResponse:
      type: object
      properties:
        url:
          type: string
          description: Link for the customer to enter credentials
    GetV1SystemsResponse:
      type: object
      properties:
        id:
          type: string
          description: System identifier
        name:
          type: string
          description: System name
  securitySchemes:
    Bearer_token:
      type: http
      scheme: bearer
      x-source: https://docs.twine.se/api-reference/authentication.md
tags:
- name: Org
- name: Systems
security:
- Bearer_token: []