Torii

Torii Metadata API

Retrieve field metadata for apps, users, and contracts.

GitHub OpenAPI

Documentation

📖
Documentation
https://developers.toriihq.com/reference/introduction-1

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/torii/refs/heads/main/openapi/torii-metadata-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/torii/refs/heads/main/json-schema/app.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/torii/refs/heads/main/json-schema/user.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/torii/refs/heads/main/json-schema/contract.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/torii/refs/heads/main/json-schema/audit-log-entry.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/torii/refs/heads/main/json-schema/field-metadata.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/torii/refs/heads/main/json-schema/parsing-request.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/torii/refs/heads/main/json-schema/scim-user.json

Other Resources

🔗
Website
https://www.toriihq.com/
🔗
SpectralRules
https://raw.githubusercontent.com/api-evangelist/torii/refs/heads/main/rules/torii-rules.yml
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/torii/refs/heads/main/json-ld/torii-context.jsonld

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/torii-metadata-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 email required.

GitHub Google LinkedIn

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

OpenAPI Specification

torii-metadata-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Torii Apps Metadata API
  description: The Torii API provides programmatic access to the Torii SaaS Management Platform. It allows you to manage apps, users, contracts, licenses, audit logs, and file uploads. The API closely follows REST semantics, uses JSON to encode objects, and relies on standard HTTP codes to signal operation outcomes. Torii APIs consist of both proprietary and SCIM 2.0 APIs.
  version: 1.1.0
  contact:
    name: Torii
    url: https://developers.toriihq.com
  termsOfService: https://www.toriihq.com/terms
servers:
- url: https://api.toriihq.com/v1.0
  description: Torii API v1.0
- url: https://api.toriihq.com/v1.1
  description: Torii API v1.1
security:
- bearerAuth: []
tags:
- name: Metadata
  description: Retrieve field metadata for apps, users, and contracts.
paths:
  /apps/metadata:
    get:
      operationId: getAppsMetadata
      summary: Torii List app fields metadata
      description: Lists app fields (predefined and custom), searchable by field name or key.
      tags:
      - Metadata
      parameters:
      - name: search
        in: query
        description: Search by field name or key.
        schema:
          type: string
      - $ref: '#/components/parameters/apiVersion'
      responses:
        '200':
          description: A list of app field metadata.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/FieldMetadata'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
  /users/metadata:
    get:
      operationId: getUsersMetadata
      summary: Torii List user fields metadata
      description: Lists user fields (predefined and custom), searchable by field name or key.
      tags:
      - Metadata
      parameters:
      - name: search
        in: query
        description: Search by field name or key.
        schema:
          type: string
      - $ref: '#/components/parameters/apiVersion'
      responses:
        '200':
          description: A list of user field metadata.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/FieldMetadata'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
  /contracts/metadata:
    get:
      operationId: getContractsMetadata
      summary: Torii List contract fields metadata
      description: Lists contract fields (predefined and custom), searchable by field name or key.
      tags:
      - Metadata
      parameters:
      - name: search
        in: query
        description: Search by field name or key.
        schema:
          type: string
      - $ref: '#/components/parameters/apiVersion'
      responses:
        '200':
          description: A list of contract field metadata.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/FieldMetadata'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    FieldMetadata:
      type: object
      properties:
        key:
          type: string
          description: Field key identifier.
        name:
          type: string
          description: Display name of the field.
        type:
          type: string
          description: Data type of the field.
        isCustom:
          type: boolean
          description: Whether this is a custom field.
        isRequired:
          type: boolean
          description: Whether this field is required.
  responses:
    RateLimited:
      description: Rate limit exceeded. Too many requests.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              message:
                type: string
    Unauthorized:
      description: Authentication failed. Invalid or missing API key.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              message:
                type: string
  parameters:
    apiVersion:
      name: X-API-Version
      in: header
      description: 'Override the default API version. Supported values: 1.0, 1.1. Default is 1.0 for keys created before Feb 1st 2025, and 1.1 for keys created after.'
      schema:
        type: string
        enum:
        - '1.0'
        - '1.1'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key authentication. Generate an API key from Settings > API Access in Torii. Use the Authorization header: Bearer {API_KEY}.'