seekrit-dev docs API

openapi: 3.1.0
info:
  title: seekrit-dev docs API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 29 operation(s) read from 11 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; seekrit-dev has published no machine-readable contract
    that the pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 26
    documentation: 118
    pages-with-code: 27
    pages-read: 40
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://developers.openai.com/api/docs/guides/agents-api/configuration
  - https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted
  - https://developers.openai.com/api/docs/guides/agents-api/environments/prewarmed
  - https://developers.openai.com/api/docs/guides/agents-api/observability
  - https://developers.openai.com/api/docs/guides/agents-api/overview
  - https://developers.openai.com/api/docs/guides/agents-api/quickstart
  - https://developers.openai.com/api/docs/guides/agents-api/sessions
  - https://developers.openai.com/api/docs/guides/agents-api/sessions/automations
  - https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use
  - https://developers.openai.com/api/docs/guides/agents-api/tools/vaults
  - https://developers.openai.com/api/docs/guides/agents-api/tracing
  x-docs-section: docs
servers:
- url: https://api.seekrit.dev
paths:
  /user:
    get:
      operationId: get_user
      tags:
      - User
      summary: GET /user
      x-source: https://developers.openai.com/api/docs/guides/agents-api/tools/vaults
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.github.com/user  -H \"Authorization: Bearer $GITHUB_TOKEN \" \n The command reads the placeholder from GITHUB_TOKEN\
          \ . The proxy replaces it with the real token before sending the request to api.github.com . A successful request returns the authenticated\
          \ GitHub user’s account details as JSON. Printing the variable inside the sandbox shows the placeholder, not the token. \n Pass the\
          \ pla"
  /v1/agents/automations:
    get:
      operationId: get_v1_agents_automations
      tags:
      - Agents
      summary: GET /v1/agents/automations
      x-source: https://developers.openai.com/api/docs/guides/agents-api/sessions/automations
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.openai.com/v1/agents/automations  -H \"OpenAI-Beta: agents=v1\"  -H \"Authorization: Bearer $OPENAI_API_KEY\"\
          \  -H \"Content-Type: application/json\"  -d @- <<EOF \n { \n \"type\": \"once\", \n \"name\": \"Onboarding follow-up\", \n \"run_at\"\
          : $RUN_AT, \n \"target\": { \n \"type\": \"existing_session\", \n \"session_id\": \"sess_123\", \n \"instructions\": \"Review onboarding\
          \ progress and send the next onboarding mes"
    post:
      operationId: post_v1_agents_automations
      tags:
      - Agents
      summary: POST /v1/agents/automations
      x-source: https://developers.openai.com/api/docs/guides/agents-api/sessions/automations
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1AgentsAutomationsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.openai.com/v1/agents/automations  -H \"OpenAI-Beta: agents=v1\"  -H \"Authorization: Bearer $OPENAI_API_KEY\"\
          \  -H \"Content-Type: application/json\"  -d '{ \n \"type\": \"periodic\", \n \"name\": \"Daily session\", \n \"expression\": \"0 10\
          \ * * *\", \n \"timezone\": \"America/New_York\", \n \"target\": { \n \"type\": \"new_session\", \n \"agent_id\": \"agt_123\", \n \"\
          environment\": { \n \"type\": \"openai_hosted\" \n }, \n \"inp"
  /v1/agents/automations/auto_123:
    delete:
      operationId: delete_v1_agents_automations_auto_123
      tags:
      - Agents
      summary: Remove the schedule and prevent future invocations.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/sessions/automations
      responses:
        '204':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_v1_agents_automations_auto_123
      tags:
      - Agents
      summary: Retrieve a specific automation.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/sessions/automations
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1AgentsAutomationsAuto123Response'
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_agents_automations_auto_123
      tags:
      - Agents
      summary: POST /v1/agents/automations/auto_123
      x-source: https://developers.openai.com/api/docs/guides/agents-api/sessions/automations
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1AgentsAutomationsAuto123Request'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.openai.com/v1/agents/automations/auto_123  -H \"OpenAI-Beta: agents=v1\"  -H \"Authorization: Bearer $OPENAI_API_KEY\"\
          \  -H \"Content-Type: application/json\"  -d '{ \n \"expression\": \"0 11 * * *\" \n }' \n Omitted fields stay unchanged. A supplied\
          \ target replaces the whole target, so include all its required fields and retain its type. Update reminder text in target.instructions\
          \ or initial m"
  /v1/agents/automations/auto_123/invocations:
    get:
      operationId: get_v1_agents_automations_auto_123_invocations
      tags:
      - Agents
      summary: GET /v1/agents/automations/auto_123/invocations
      x-source: https://developers.openai.com/api/docs/guides/agents-api/sessions/automations
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.openai.com/v1/agents/automations/auto_123/invocations  -H \"OpenAI-Beta: agents=v1\"  -H \"Authorization: Bearer\
          \ $OPENAI_API_KEY\" \n API resources Agents /v1/agents Define the instructions and tools for the task. Automations /v1/agents/automations\
          \ Save when to run and which session to use. Invocations /v1/agents/automations/{automation_id}/invocations See when a task was sent\
          \ and whic"
    post:
      operationId: post_v1_agents_automations_auto_123_invocations
      tags:
      - Agents
      summary: Manually invoke an automation immediately.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/sessions/automations
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1AgentsAutomationsAuto123InvocationsResponse'
      x-evidence:
        kind: documentation
  /v1/agents/automations/auto_123/invocations/ainv_123:
    get:
      operationId: get_v1_agents_automations_auto_123_invocations_ainv_123
      tags:
      - Agents
      summary: Retrieve a specific invocation.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/sessions/automations
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1AgentsAutomationsAuto123InvocationsAinv123Response'
      x-evidence:
        kind: documentation
  /v1/agents/automations/auto_123/pause:
    post:
      operationId: post_v1_agents_automations_auto_123_pause
      tags:
      - Agents
      summary: Pause scheduled work for an automation.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/sessions/automations
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1AgentsAutomationsAuto123PauseResponse'
      x-evidence:
        kind: documentation
  /v1/agents/automations/auto_123/resume:
    post:
      operationId: post_v1_agents_automations_auto_123_resume
      tags:
      - Agents
      summary: Resume scheduled work for an automation.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/sessions/automations
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1AgentsAutomationsAuto123ResumeResponse'
      x-evidence:
        kind: documentation
  /v1/agents/environments:
    get:
      operationId: get_v1_agents_environments
      tags:
      - Agents
      summary: List active environments created by your identity in the current organization and project.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/environments/prewarmed
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum number of environments to return (1–100, default 20)
      - name: order
        in: query
        required: false
        schema:
          type: string
        description: Sort order (asc or desc, default desc)
      - name: after
        in: query
        required: false
        schema:
          type: string
        description: Pagination cursor for fetching the next page
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1AgentsEnvironmentsResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_agents_environments
      tags:
      - Agents
      summary: POST /v1/agents/environments
      x-source: https://developers.openai.com/api/docs/guides/agents-api/environments/prewarmed
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1AgentsEnvironmentsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.openai.com/v1/agents/environments  -H \"OpenAI-Beta: agents=v1\"  -H \"Authorization: Bearer $OPENAI_API_KEY\"\
          \  -H \"Content-Type: application/json\"  -d '{ \n \"environment\": { \n \"type\": \"openai_hosted\", \n \"packages\": { \n \"python\"\
          : [\"pandas==2.2.3\"] \n }, \n \"files\": [ \n { \n \"type\": \"inline\", \n \"path\": \"/workspace/amounts.csv\", \n \"data\": \"YW1vdW50CjEwCjIwCjMwCg==\"\
          \ \n } \n ], \n \"setup_command"
  /v1/agents/environments/{environmentId}:
    get:
      operationId: get_v1_agents_environments_environmentId
      tags:
      - Agents
      summary: Retrieve the status of an OpenAI-hosted sandbox environment.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted
      parameters:
      - name: environmentId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1AgentsEnvironmentsEnvironmentidResponse'
      x-evidence:
        kind: documentation
  /v1/agents/sessions:
    delete:
      operationId: delete_v1_agents_sessions
      tags:
      - Agents
      summary: DELETE /v1/agents/sessions
      x-source: https://developers.openai.com/api/docs/guides/agents-api/quickstart
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteV1AgentsSessionsRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl. \n 1. Run a task \n Choose a language, install the OpenAI SDK, and run the example. The SDK examples use the beta.agents\
          \ namespace. The request creates a session, submits a task, and streams progress. \n Python JavaScript Go Java Ruby cURL Python Install\
          \ or update the Python SDK: pip install --upgrade openai Save the example as quickstart.py : Create and run tree.py 1 \n 2 \n 3 \n 4\
          \ \n 5 \n 6 \n 7 \n "
    get:
      operationId: get_v1_agents_sessions
      tags:
      - Agents
      summary: Retrieve a list of agent sessions.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/quickstart
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1AgentsSessionsResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_agents_sessions
      tags:
      - Agents
      summary: POST /v1/agents/sessions
      x-source: https://developers.openai.com/api/docs/guides/agents-api/overview
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1AgentsSessionsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -sS -X POST \"https://api.openai.com/v1/agents/sessions\"  -H \"OpenAI-Beta: agents=v1\"  -H \"Authorization: Bearer $OPENAI_API_KEY\"\
          \  -H \"Content-Type: application/json\"  -d '{ \n \"agent\": { \n \"model\": \"gpt-6-astra\", \n \"instructions\": \"Use the OpenAI\
          \ documentation MCP and web search to answer technical questions accurately. Delegate independent research tasks to subagents when useful.\"\
          , \n \"tools\":"
  /v1/agents/sessions/$session_id:
    delete:
      operationId: delete_v1_agents_sessions_session_id
      tags:
      - Agents
      summary: DELETE /v1/agents/sessions/$session_id
      x-source: https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteV1AgentsSessionsSessionIdRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --fail-with-body -X DELETE \"https://api.openai.com/v1/agents/sessions/$session_id\"  -H \"OpenAI-Beta: agents=v1\"  -H\
          \ \"Authorization: Bearer $OPENAI_API_KEY\" await client.beta.agents.sessions. delete (session.id); if ready_to_delete: \n client.beta.agents.sessions.delete(session.id)\
          \ readyToDelete := false \n defer func() { \n if !readyToDelete { \n fmt.Fprintf(os.Stderr, \"Session %s was not deleted"
    get:
      operationId: get_v1_agents_sessions_session_id
      tags:
      - Agents
      summary: GET /v1/agents/sessions/$session_id
      x-source: https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1AgentsSessionsSessionIdResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl --silent --show-error --fail-with-body "https://api.openai.com/v1/agents/sessions/$session_id"  -H "OpenAI-Beta: agents=v1"  -H
          "Authorization: Bearer $OPENAI_API_KEY"  | jq ''.required_actions[] | select(.type == "computer_use_approval_request")'' '
  /v1/agents/sessions/$session_id/events:
    post:
      operationId: post_v1_agents_sessions_session_id_events
      tags:
      - Agents
      summary: POST /v1/agents/sessions/$session_id/events
      x-source: https://developers.openai.com/api/docs/guides/agents-api/sessions
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1AgentsSessionsSessionIdEventsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl  \"https://api.openai.com/v1/agents/sessions/$session_id/events\"  -H \"OpenAI-Beta: agents=v1\"  -H \"Authorization: Bearer\
          \ $OPENAI_API_KEY\"  -H \"Idempotency-Key: $submission_key\"  -H \"Content-Type: application/json\"  -d '{ \n \"events\": [ \n { \n\
          \ \"type\": \"agent.session.input.message\", \n \"input\": [ \n { \n \"role\": \"user\", \n \"content\": [ \n { \n \"type\": \"input_text\"\
          , \n \"text\": \"List the files in the curre"
  /v1/agents/sessions/$session_id/items:
    get:
      operationId: get_v1_agents_sessions_session_id_items
      tags:
      - Agents
      summary: GET /v1/agents/sessions/$session_id/items
      x-source: https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --silent --show-error --fail-with-body --get  \"https://api.openai.com/v1/agents/sessions/$session_id/items\"  -H \"OpenAI-Beta:\
          \ agents=v1\"  -H \"Authorization: Bearer $OPENAI_API_KEY\"  --data-urlencode \"order=asc\" --data-urlencode \"limit=100\"  --output\
          \ \"$activity_file\" \n jq '.data[] | select(.type == \"computer_use_call\") | \n {id, title: (.title // \"Browser activity\"), status,\
          \ \n has_screenshot: ("
  /v1/agents/sessions/sess_123:
    get:
      operationId: get_v1_agents_sessions_sess_123
      tags:
      - Agents
      summary: Retrieve a specific agent session by ID.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/quickstart
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1AgentsSessionsSess123Response'
      x-evidence:
        kind: documentation
  /v1/agents/sessions/sess_123/turns:
    get:
      operationId: get_v1_agents_sessions_sess_123_turns
      tags:
      - Agents
      summary: GET /v1/agents/sessions/sess_123/turns
      x-source: https://developers.openai.com/api/docs/guides/agents-api/observability
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
      - name: order
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://api.openai.com/v1/agents/sessions/sess_123/turns?limit=20&order=desc"  -H "OpenAI-Beta: agents=v1"  -H "Authorization:
          Bearer $OPENAI_API_KEY" '
  /v1/agents/sessions/sess_123/turns/turn_123:
    get:
      operationId: get_v1_agents_sessions_sess_123_turns_turn_123
      tags:
      - Agents
      summary: GET /v1/agents/sessions/sess_123/turns/turn_123
      x-source: https://developers.openai.com/api/docs/guides/agents-api/observability
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \"https://api.openai.com/v1/agents/sessions/sess_123/turns/turn_123\"  -H \"OpenAI-Beta: agents=v1\"  -H \"Authorization:\
          \ Bearer $OPENAI_API_KEY\" | jq '.subagent_id' \n For manual pagination, use the returned last_id as the next page’s after value when\
          \ has_more is true . The Go example follows these pages automatically. \n Command items contain turn_id . Retrieve that turn and read\
          \ subagent_id to id"
  /v1/agents/sessions/{sessionId}:
    post:
      operationId: post_v1_agents_sessions_sessionId
      tags:
      - Agents
      summary: Update settings for an existing session.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/configuration
      parameters:
      - name: sessionId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1AgentsSessionsSessionidRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1AgentsSessionsSessionidResponse'
      x-evidence:
        kind: documentation
  /v1/agents/sessions/{sessionId}/events:
    get:
      operationId: get_v1_agents_sessions_sessionId_events
      tags:
      - Agents
      summary: Retrieve session events for streaming agent activity and setup status.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/environments/prewarmed
      parameters:
      - name: sessionId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1AgentsSessionsSessionidEventsResponse'
      x-evidence:
        kind: documentation
  /v1/agents/sessions/{sessionId}/traces:
    get:
      operationId: get_v1_agents_sessions_sessionId_traces
      tags:
      - Agents
      summary: Export session traces containing OpenTelemetry Protocol (OTLP) JSON.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/tracing
      parameters:
      - name: sessionId
        in: path
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Number of traces to return per page
      - name: order
        in: query
        required: false
        schema:
          type: string
        description: Order of traces (asc or desc)
      - name: after
        in: query
        required: false
        schema:
          type: string
        description: Cursor for pagination
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1AgentsSessionsSessionidTracesResponse'
      x-evidence:
        kind: documentation
  /v1/vaults/{vaultId}/credentials:
    post:
      operationId: post_v1_vaults_vaultId_credentials
      tags:
      - Vaults
      summary: Create a credential in a vault to store authentication secrets for MCP connections or sandbox API requests.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/tools/vaults
      parameters:
      - name: vaultId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1VaultsVaultidCredentialsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1VaultsVaultidCredentialsResponse'
      x-evidence:
        kind: documentation
  /v1/vaults/{vaultId}/credentials/{credentialId}:
    post:
      operationId: post_v1_vaults_vaultId_credentials_credentialId
      tags:
      - Vaults
      summary: Update a credential to replace its secret without changing its ID or authentication type.
      x-source: https://developers.openai.com/api/docs/guides/agents-api/tools/vaults
      parameters:
      - name: vaultId
        in: path
        required: true
        schema:
          type: string
      - name: credentialId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1VaultsVaultidCredentialsCredentialidRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1VaultsVaultidCredentialsCredentialidResponse'
      x-evidence:
        kind: documentation
security:


# --- truncated at 32 KB (35 KB total) ---
# Full source: https://artifacts.apis.io/seekrit-dev/openapi/_ae-authored/seekrit-dev-docs-openapi-generated.yml