{
  "openapi": "3.1.0",
  "info": {
    "title": "ACCESS Workspace API",
    "version": "1.0-beta",
    "description": "Bounded beta. No public SQL, Clerk administration or server filesystem paths. Per key: 120 requests and 10 intelligence POSTs per minute. Keys expire in 1\u201390 days; legacy keys retain expiry. Customer retries reuse Idempotency-Key. Text-only gateway; tool transcripts are context, not tool execution."
  },
  "servers": [
    {
      "url": "https://getaccess.world"
    }
  ],
  "security": [
    {
      "AccessApiKey": []
    }
  ],
  "components": {
    "securitySchemes": {
      "AccessApiKey": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "acc_live_<32 base64url characters>"
      }
    }
  },
  "paths": {
    "/api/v1/me": {
      "get": {
        "summary": "Read key identity and scopes",
        "description": "Any valid key. Vault summaries require read.",
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Invalid request"
          },
          "401": {
            "description": "Missing, invalid, revoked or expired key"
          },
          "403": {
            "description": "Required scope missing"
          },
          "429": {
            "description": "Rate limit reached; Retry-After indicates seconds"
          },
          "503": {
            "description": "Required service unavailable"
          }
        }
      }
    },
    "/api/v1/customers": {
      "get": {
        "summary": "List owned customers",
        "description": "Requires read scope.",
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Invalid request"
          },
          "401": {
            "description": "Missing, invalid, revoked or expired key"
          },
          "403": {
            "description": "Required scope missing"
          },
          "429": {
            "description": "Rate limit reached; Retry-After indicates seconds"
          },
          "503": {
            "description": "Required service unavailable"
          }
        }
      },
      "post": {
        "summary": "Create customer; safe idempotent retries",
        "description": "Requires customers:write scope.",
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Invalid request"
          },
          "401": {
            "description": "Missing, invalid, revoked or expired key"
          },
          "403": {
            "description": "Required scope missing"
          },
          "429": {
            "description": "Rate limit reached; Retry-After indicates seconds"
          },
          "503": {
            "description": "Required service unavailable"
          },
          "201": {
            "description": "Created"
          },
          "409": {
            "description": "Key reused with different details"
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 8,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._:-]+$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "email": {
                    "type": "string",
                    "maxLength": 254
                  },
                  "company": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "title": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "notes": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "stage": {
                    "type": "string",
                    "maxLength": 20,
                    "enum": [
                      "new",
                      "contacted",
                      "conversation",
                      "won",
                      "lost"
                    ]
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/vault/search": {
      "get": {
        "summary": "Search synced owned vault excerpts",
        "description": "Requires read scope.",
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Invalid request"
          },
          "401": {
            "description": "Missing, invalid, revoked or expired key"
          },
          "403": {
            "description": "Required scope missing"
          },
          "429": {
            "description": "Rate limit reached; Retry-After indicates seconds"
          },
          "503": {
            "description": "Required service unavailable"
          }
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2000
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "default": 8
            }
          }
        ]
      }
    },
    "/api/v1/jyson/ask": {
      "post": {
        "summary": "Ask JYSON with cloud vault context",
        "description": "Requires jyson scope.",
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Invalid request"
          },
          "401": {
            "description": "Missing, invalid, revoked or expired key"
          },
          "403": {
            "description": "Required scope missing"
          },
          "429": {
            "description": "Rate limit reached; Retry-After indicates seconds"
          },
          "503": {
            "description": "Required service unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "question"
                ],
                "properties": {
                  "question": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4000
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/models": {
      "get": {
        "summary": "List Zin models",
        "description": "Requires jyson scope.",
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Invalid request"
          },
          "401": {
            "description": "Missing, invalid, revoked or expired key"
          },
          "403": {
            "description": "Required scope missing"
          },
          "429": {
            "description": "Rate limit reached; Retry-After indicates seconds"
          },
          "503": {
            "description": "Required service unavailable"
          }
        }
      }
    },
    "/api/v1/models/{id}": {
      "get": {
        "summary": "Read a Zin model",
        "description": "Requires jyson scope.",
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Invalid request"
          },
          "401": {
            "description": "Missing, invalid, revoked or expired key"
          },
          "403": {
            "description": "Required scope missing"
          },
          "429": {
            "description": "Rate limit reached; Retry-After indicates seconds"
          },
          "503": {
            "description": "Required service unavailable"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/api/v1/chat/completions": {
      "post": {
        "summary": "OpenAI-compatible text chat through JYSON",
        "description": "Requires jyson scope.",
        "responses": {
          "200": {
            "description": "Success"
          },
          "400": {
            "description": "Invalid request"
          },
          "401": {
            "description": "Missing, invalid, revoked or expired key"
          },
          "403": {
            "description": "Required scope missing"
          },
          "429": {
            "description": "Rate limit reached; Retry-After indicates seconds"
          },
          "503": {
            "description": "Required service unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "model",
                  "messages"
                ],
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "stream": {
                    "type": "boolean",
                    "default": true
                  },
                  "messages": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 100,
                    "items": {
                      "type": "object",
                      "required": [
                        "role"
                      ],
                      "properties": {
                        "role": {
                          "type": "string",
                          "enum": [
                            "system",
                            "developer",
                            "user",
                            "assistant",
                            "tool",
                            "function"
                          ]
                        },
                        "content": {
                          "oneOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "required": [
                                  "type",
                                  "text"
                                ],
                                "properties": {
                                  "type": {
                                    "const": "text"
                                  },
                                  "text": {
                                    "type": "string"
                                  }
                                }
                              }
                            }
                          ]
                        },
                        "tool_calls": {
                          "type": "array"
                        },
                        "name": {
                          "type": "string"
                        },
                        "tool_call_id": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}