{
 "components": {
  "securitySchemes": {
   "apiKey": {
    "type": "apiKey",
    "in": "header",
    "name": "X-API-Key",
    "description": "Optional scoped key (company:read, pricing:read, search:read). Issue one at POST /agent-api/v1/keys."
   },
   "bearer": {
    "scheme": "bearer",
    "type": "http"
   }
  }
 },
 "info": {
  "description": "Creator gigs and bids. Reads are public. Writes need an API key from Settings (Bearer). Right now there are 0 live gigs and 0 open requests. Buyer totals include a 5% service fee. Creators pay 10% commission on completed work. Subscription commission is 15%.",
  "title": "Shootlyst API",
  "version": "1.0"
 },
 "openapi": "3.1.0",
 "paths": {
  "/agent-api/v1/company": {
   "get": {
    "operationId": "getCompany",
    "summary": "Company profile and agent entry points",
    "security": [
     {},
     {
      "apiKey": []
     }
    ],
    "x-scope": "company:read",
    "x-free": true,
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "403": {
      "description": "key lacks the scope"
     },
     "429": {
      "description": "rate limited"
     }
    },
    "x-pricing": {
     "price_usd": 0,
     "metered": false,
     "note": "free; anonymous 30 req/min, key 300 req/min"
    }
   }
  },
  "/agent-api/v1/pricing": {
   "get": {
    "operationId": "getPricing",
    "summary": "Plans and USD prices",
    "security": [
     {},
     {
      "apiKey": []
     }
    ],
    "x-scope": "pricing:read",
    "x-free": true,
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "403": {
      "description": "key lacks the scope"
     },
     "429": {
      "description": "rate limited"
     }
    },
    "x-pricing": {
     "price_usd": 0,
     "metered": false,
     "note": "free; anonymous 30 req/min, key 300 req/min"
    }
   }
  },
  "/api/pricing": {
   "get": {
    "operationId": "apiPricing",
    "summary": "Plans and USD prices (plan, interval, amount_usd, currency, what_you_get)",
    "security": [
     {},
     {
      "apiKey": []
     }
    ],
    "x-scope": "pricing:read",
    "x-free": true,
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "403": {
      "description": "key lacks the scope"
     },
     "429": {
      "description": "rate limited"
     }
    },
    "x-pricing": {
     "price_usd": 0,
     "metered": false,
     "note": "free; anonymous 30 req/min, key 300 req/min"
    }
   }
  },
  "/agent-api/v1/search": {
   "get": {
    "operationId": "searchSite",
    "summary": "Search pages on this site",
    "security": [
     {},
     {
      "apiKey": []
     }
    ],
    "x-scope": "search:read",
    "x-free": true,
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "403": {
      "description": "key lacks the scope"
     },
     "429": {
      "description": "rate limited"
     }
    },
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "schema": {
       "type": "integer",
       "default": 5
      }
     }
    ],
    "x-pricing": {
     "price_usd": 0,
     "metered": false,
     "note": "free; anonymous 30 req/min, key 300 req/min"
    }
   }
  },
  "/agent-api/v1/keys": {
   "post": {
    "x-pricing": {
     "price_usd": 0,
     "metered": false,
     "note": "free; anonymous 30 req/min, key 300 req/min"
    },
    "operationId": "createKey",
    "summary": "Issue a scoped API key (shown once)",
    "security": [
     {}
    ],
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "scopes": {
          "type": "array",
          "items": {
           "type": "string",
           "enum": [
            "company:read",
            "pricing:read",
            "search:read"
           ]
          }
         },
         "label": {
          "type": "string"
         }
        }
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "key issued"
     },
     "429": {
      "description": "too many keys from this address"
     }
    }
   }
  },
  "/agent-api/v1/keys/me": {
   "get": {
    "x-pricing": {
     "price_usd": 0,
     "metered": false,
     "note": "free; anonymous 30 req/min, key 300 req/min"
    },
    "operationId": "getKey",
    "summary": "Scopes of the presented key",
    "security": [
     {
      "apiKey": []
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "missing or unknown key"
     }
    }
   }
  },
  "/mcp": {
   "post": {
    "x-pricing": {
     "price_usd": 0,
     "metered": false,
     "note": "free; anonymous 30 req/min, key 300 req/min"
    },
    "operationId": "mcp",
    "summary": "MCP streamable HTTP endpoint (JSON-RPC 2.0)",
    "security": [
     {},
     {
      "apiKey": []
     }
    ],
    "responses": {
     "200": {
      "description": "JSON-RPC response"
     }
    }
   }
  },
  "/api/v1/categories": {
   "get": {
    "operationId": "listCategories",
    "responses": {
     "200": {
      "description": "ok"
     }
    },
    "summary": "SFW categories and minimum prices"
   }
  },
  "/api/v1/directory": {
   "get": {
    "operationId": "searchDirectory",
    "responses": {
     "200": {
      "description": "ok"
     }
    },
    "summary": "Public SFW businesses with ODbL attribution"
   }
  },
  "/api/v1/directory/{id}/claim": {
   "post": {
    "operationId": "claimBusiness",
    "parameters": [
     {
      "in": "path",
      "name": "id",
      "required": true,
      "schema": {
       "type": "integer"
      }
     }
    ],
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "properties": {
         "action": {
          "enum": [
           "send",
           "verify",
           "remove"
          ],
          "type": "string"
         },
         "code": {
          "type": "string"
         }
        },
        "required": [
         "action"
        ],
        "type": "object"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "ok"
     },
     "401": {
      "description": "API key required"
     },
     "403": {
      "description": "ownership required"
     },
     "429": {
      "description": "rate limited"
     }
    },
    "security": [
     {
      "bearer": []
     }
    ],
    "summary": "Send or verify contact proof; verified owner removal"
   }
  },
  "/api/v1/gigs": {
   "get": {
    "operationId": "searchGigs",
    "parameters": [
     {
      "in": "query",
      "name": "q",
      "schema": {
       "type": "string"
      }
     },
     {
      "in": "query",
      "name": "category",
      "schema": {
       "description": "SFW category slugs: voice-over, music, custom-photo-video, ugc-creators, b-roll, actors-voice, models, photographers, short-form-editors, shoutouts, 1-1-video-consult-live-session, livestream-host-co-host, language-and-voice-coaching, virtual-product-demo",
       "enum": [
        "voice-over",
        "music",
        "custom-photo-video",
        "ugc-creators",
        "b-roll",
        "actors-voice",
        "models",
        "photographers",
        "short-form-editors",
        "shoutouts",
        "1-1-video-consult-live-session",
        "livestream-host-co-host",
        "language-and-voice-coaching",
        "virtual-product-demo"
       ],
       "type": "string"
      }
     },
     {
      "in": "query",
      "name": "max_price",
      "schema": {
       "type": "number"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "ok"
     }
    },
    "summary": "Search live gigs"
   }
  },
  "/api/v1/messages": {
   "get": {
    "operationId": "listMessages",
    "responses": {
     "200": {
      "description": "ok"
     }
    },
    "security": [
     {
      "bearer": []
     }
    ]
   },
   "post": {
    "operationId": "sendMessage",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "properties": {
         "body": {
          "type": "string"
         },
         "to": {
          "type": "string"
         }
        },
        "required": [
         "to",
         "body"
        ],
        "type": "object"
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "sent"
     }
    },
    "security": [
     {
      "bearer": []
     }
    ]
   }
  },
  "/api/v1/requests": {
   "get": {
    "operationId": "searchRequests",
    "parameters": [
     {
      "in": "query",
      "name": "q",
      "schema": {
       "type": "string"
      }
     },
     {
      "in": "query",
      "name": "category",
      "schema": {
       "description": "SFW category slugs: voice-over, music, custom-photo-video, ugc-creators, b-roll, actors-voice, models, photographers, short-form-editors, shoutouts, 1-1-video-consult-live-session, livestream-host-co-host, language-and-voice-coaching, virtual-product-demo",
       "enum": [
        "voice-over",
        "music",
        "custom-photo-video",
        "ugc-creators",
        "b-roll",
        "actors-voice",
        "models",
        "photographers",
        "short-form-editors",
        "shoutouts",
        "1-1-video-consult-live-session",
        "livestream-host-co-host",
        "language-and-voice-coaching",
        "virtual-product-demo"
       ],
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "ok"
     }
    },
    "summary": "Search open requests"
   },
   "post": {
    "operationId": "postRequest",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "properties": {
         "budget_usd": {
          "type": "number"
         },
         "category": {
          "enum": [
           "voice-over",
           "music",
           "custom-photo-video",
           "ugc-creators",
           "b-roll",
           "actors-voice",
           "models",
           "photographers",
           "short-form-editors",
           "shoutouts",
           "1-1-video-consult-live-session",
           "livestream-host-co-host",
           "language-and-voice-coaching",
           "virtual-product-demo"
          ],
          "type": "string"
         },
         "days": {
          "type": "integer"
         },
         "details": {
          "type": "string"
         },
         "title": {
          "type": "string"
         }
        },
        "required": [
         "title",
         "category",
         "budget_usd"
        ],
        "type": "object"
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "created"
     },
     "401": {
      "description": "no key"
     }
    },
    "security": [
     {
      "bearer": []
     }
    ],
    "summary": "Post a request"
   }
  },
  "/api/v1/requests/{id}/bids": {
   "post": {
    "operationId": "placeBid",
    "parameters": [
     {
      "in": "path",
      "name": "id",
      "required": true,
      "schema": {
       "type": "integer"
      }
     }
    ],
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "properties": {
         "days": {
          "type": "integer"
         },
         "note": {
          "type": "string"
         },
         "price_usd": {
          "type": "number"
         }
        },
        "required": [
         "price_usd"
        ],
        "type": "object"
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "created"
     }
    },
    "security": [
     {
      "bearer": []
     }
    ],
    "summary": "Place a sealed bid (verified creators)"
   }
  }
 },
 "servers": [
  {
   "url": "https://shootlyst.eliteaiempire.com"
  }
 ],
 "x-f7455-augmented": "agent endpoints + optional scoped API keys added by the F7455 agent surface"
}