{
 "openapi": "3.1.0",
 "info": {
  "title": "AudioChad API",
  "version": "1",
  "description": "The API the web app, the iPhone app, and the MCP server use. Scripts sign in with a personal API key from Account (Authorization: Bearer ac_\u2026); apps connect with OAuth 2.1. Every key and app can read; write, share, and delete are granted separately (x-scope on each operation). Keys and apps are rate limited: 120 reads and 30 changes a minute, and 20 uploads, imports, edits, loudness changes, or exports every 10 minutes; over the limit is 429 with Retry-After. Times are Unix nanoseconds unless named Ms. Lists that can grow large page with cursor and next."
 },
 "servers": [
  {
   "url": "https://soundboard.rfelix13.com"
  }
 ],
 "security": [
  {
   "apiKey": []
  },
  {
   "oauth": []
  },
  {
   "session": []
  }
 ],
 "tags": [
  {
   "name": "Sounds"
  },
  {
   "name": "Editing"
  },
  {
   "name": "Boards"
  },
  {
   "name": "Sharing"
  },
  {
   "name": "Account"
  },
  {
   "name": "Agents"
  },
  {
   "name": "Public"
  },
  {
   "name": "Admin"
  }
 ],
 "paths": {
  "/v1/admin/status": {
   "get": {
    "operationId": "adminStatus",
    "summary": "Sign-in and server status",
    "tags": [
     "Admin"
    ],
    "description": "Used by the web app and iOS to learn who's signed in.",
    "responses": {
     "200": {
      "description": "Status."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/v1/admin/users": {
   "get": {
    "operationId": "adminUsers",
    "summary": "List accounts",
    "tags": [
     "Admin"
    ],
    "description": "Admins signed in to a session only.",
    "responses": {
     "200": {
      "description": "Accounts."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/admin/users/{id}": {
   "patch": {
    "operationId": "adminUpdateUser",
    "summary": "Change an account's role or plan",
    "tags": [
     "Admin"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The account's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "role": {
          "type": "string",
          "enum": [
           "admin",
           "friend"
          ]
         },
         "plan": {
          "type": "string",
          "enum": [
           "free",
           "plus",
           "pro"
          ]
         }
        }
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The account."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/admin/users/{id}/password": {
   "post": {
    "operationId": "adminResetPassword",
    "summary": "Set an account's password",
    "tags": [
     "Admin"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The account's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "password": {
          "type": "string"
         },
         "confirmPassword": {
          "type": "string"
         }
        },
        "required": [
         "password",
         "confirmPassword"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "Done."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/boards": {
   "get": {
    "operationId": "listBoards",
    "summary": "List boards",
    "tags": [
     "Boards"
    ],
    "description": "Boards this account owns or was invited to.",
    "responses": {
     "200": {
      "description": "Boards.",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "$ref": "#/components/schemas/Board"
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   },
   "post": {
    "operationId": "createBoard",
    "summary": "Make a board",
    "tags": [
     "Boards"
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "name": {
          "type": "string"
         }
        },
        "required": [
         "name"
        ]
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "The board.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Board"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/boards/{id}": {
   "patch": {
    "operationId": "renameBoard",
    "summary": "Rename a board",
    "tags": [
     "Boards"
    ],
    "description": "Owners only.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The board's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "name": {
          "type": "string"
         }
        },
        "required": [
         "name"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The board.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Board"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   },
   "delete": {
    "operationId": "deleteBoard",
    "summary": "Delete a board",
    "tags": [
     "Boards"
    ],
    "description": "Owners only. The sounds stay in their owners' libraries.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The board's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "204": {
      "description": "Deleted."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "delete"
   }
  },
  "/v1/boards/{id}/invites": {
   "get": {
    "operationId": "listInvites",
    "summary": "List a board's invite links",
    "tags": [
     "Boards"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The board's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Invites.",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "$ref": "#/components/schemas/BoardInvite"
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   },
   "post": {
    "operationId": "createInvite",
    "summary": "Make an invite link",
    "tags": [
     "Boards"
    ],
    "description": "Owners only. Lasts 30 days.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The board's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "role": {
          "type": "string",
          "enum": [
           "editor",
           "viewer"
          ]
         }
        },
        "required": [
         "role"
        ]
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "The invite.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "integer"
          },
          "role": {
           "type": "string"
          },
          "expiresAt": {
           "type": "integer",
           "description": "Unix time in nanoseconds."
          },
          "url": {
           "type": "string"
          }
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "share"
   }
  },
  "/v1/boards/{id}/invites/{inviteId}": {
   "delete": {
    "operationId": "revokeInvite",
    "summary": "Revoke an invite link",
    "tags": [
     "Boards"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The board's ID.",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "inviteId",
      "in": "path",
      "required": true,
      "description": "The invite's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "204": {
      "description": "Revoked."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "share"
   }
  },
  "/v1/boards/{id}/members": {
   "get": {
    "operationId": "listMembers",
    "summary": "List a board's members",
    "tags": [
     "Boards"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The board's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Members.",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "$ref": "#/components/schemas/BoardMember"
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   },
   "post": {
    "operationId": "addMember",
    "summary": "Add someone to a board",
    "tags": [
     "Boards"
    ],
    "description": "Owners only, by account email.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The board's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "email": {
          "type": "string"
         },
         "role": {
          "type": "string",
          "enum": [
           "editor",
           "viewer"
          ]
         }
        },
        "required": [
         "email",
         "role"
        ]
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "Members.",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "$ref": "#/components/schemas/BoardMember"
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "share"
   }
  },
  "/v1/boards/{id}/members/{userId}": {
   "patch": {
    "operationId": "changeMember",
    "summary": "Change a member's role",
    "tags": [
     "Boards"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The board's ID.",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "userId",
      "in": "path",
      "required": true,
      "description": "The member's account ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "role": {
          "type": "string",
          "enum": [
           "editor",
           "viewer"
          ]
         }
        },
        "required": [
         "role"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "Members.",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "$ref": "#/components/schemas/BoardMember"
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "share"
   },
   "delete": {
    "operationId": "removeMember",
    "summary": "Remove a member, or leave",
    "tags": [
     "Boards"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The board's ID.",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "userId",
      "in": "path",
      "required": true,
      "description": "The member's account ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "204": {
      "description": "Removed."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "share"
   }
  },
  "/v1/boards/{id}/sounds": {
   "post": {
    "operationId": "addBoardSounds",
    "summary": "Add sounds to a board",
    "tags": [
     "Boards"
    ],
    "description": "Owners and editors, with sounds they own.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The board's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "ids": {
          "type": "array",
          "items": {
           "type": "string"
          }
         }
        },
        "required": [
         "ids"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The board.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Board"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   },
   "delete": {
    "operationId": "removeBoardSounds",
    "summary": "Take sounds off a board",
    "tags": [
     "Boards"
    ],
    "description": "The board's owner can remove any; editors their own.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The board's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "ids": {
          "type": "array",
          "items": {
           "type": "string"
          }
         }
        },
        "required": [
         "ids"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The board.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Board"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/changelog": {
   "get": {
    "operationId": "changelog",
    "summary": "What's new",
    "tags": [
     "Public"
    ],
    "description": "Releases, filtered for the reader.",
    "responses": {
     "200": {
      "description": "Releases.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "audience": {
           "type": "string"
          },
          "releases": {
           "type": "array",
           "items": {
            "type": "object"
           }
          }
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/v1/imports": {
   "post": {
    "operationId": "importLink",
    "summary": "Import a sound from a direct link",
    "tags": [
     "Sounds"
    ],
    "description": "A public link to an audio or video file, not a web page, up to 500 MB and 2 hours. Anything over a minute is saved as a draft.",
    "parameters": [
     {
      "name": "Idempotency-Key",
      "in": "header",
      "required": false,
      "description": "Retrying with the same key returns the first response instead of repeating the request, for a day.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "url": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "tags": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "boards": {
          "type": "array",
          "items": {
           "type": "integer"
          }
         }
        },
        "required": [
         "url"
        ]
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "The sound.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sound"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/invites/{token}": {
   "get": {
    "operationId": "inviteInfo",
    "summary": "What an invite link is for",
    "tags": [
     "Boards"
    ],
    "parameters": [
     {
      "name": "token",
      "in": "path",
      "required": true,
      "description": "From the invite link.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The invite.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "boardId": {
           "type": "integer"
          },
          "boardName": {
           "type": "string"
          },
          "ownerEmail": {
           "type": "string"
          },
          "role": {
           "type": "string"
          },
          "currentRole": {
           "type": "string"
          }
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/invites/{token}/accept": {
   "post": {
    "operationId": "acceptInvite",
    "summary": "Join a board with an invite link",
    "tags": [
     "Boards"
    ],
    "parameters": [
     {
      "name": "token",
      "in": "path",
      "required": true,
      "description": "From the invite link.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The board.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Board"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/me": {
   "get": {
    "operationId": "me",
    "summary": "Who the request acts as",
    "tags": [
     "Account"
    ],
    "responses": {
     "200": {
      "description": "The account, or null.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "account": {
           "type": [
            "object",
            "null"
           ]
          },
          "pendingAccount": {
           "type": "boolean"
          }
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "security": []
   },
   "delete": {
    "operationId": "deleteAccount",
    "summary": "Delete the account and its library",
    "tags": [
     "Account"
    ],
    "description": "Needs the password again. Admins can't delete themselves; keys and apps can't call it.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "password": {
          "type": "string"
         }
        },
        "required": [
         "password"
        ]
       }
      }
     }
    },
    "responses": {
     "204": {
      "description": "Deleted."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/me/activity": {
   "get": {
    "operationId": "activity",
    "summary": "The activity log",
    "tags": [
     "Account"
    ],
    "description": "What was changed and by whom over the last 90 days, newest first.",
    "parameters": [
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Entries per page, up to 100; 50 by default.",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "before",
      "in": "query",
      "required": false,
      "description": "An entry ID from next, for the page after.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "A page of entries.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "entries": {
           "type": "array",
           "items": {
            "$ref": "#/components/schemas/Activity"
           }
          },
          "next": {
           "type": [
            "integer",
            "null"
           ]
          }
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/me/api-keys": {
   "get": {
    "operationId": "listAPIKeys",
    "summary": "List API keys",
    "tags": [
     "Agents"
    ],
    "description": "Session only.",
    "responses": {
     "200": {
      "description": "Keys, without their tokens.",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "$ref": "#/components/schemas/APIKey"
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   },
   "post": {
    "operationId": "createAPIKey",
    "summary": "Create an API key",
    "tags": [
     "Agents"
    ],
    "description": "Session only. The token is returned this once.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "name": {
          "type": "string"
         },
         "scopes": {
          "type": "array",
          "items": {
           "type": "string",
           "enum": [
            "write",
            "delete",
            "share"
           ]
          }
         }
        },
        "required": [
         "name"
        ]
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "The key and its token.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "key": {
           "$ref": "#/components/schemas/APIKey"
          },
          "token": {
           "type": "string",
           "description": "ac_\u2026"
          }
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/me/api-keys/{id}": {
   "delete": {
    "operationId": "deleteAPIKey",
    "summary": "Delete an API key",
    "tags": [
     "Agents"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The key's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "204": {
      "description": "Deleted."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/me/connections": {
   "get": {
    "operationId": "listConnections",
    "summary": "List connected apps",
    "tags": [
     "Agents"
    ],
    "description": "Session only.",
    "responses": {
     "200": {
      "description": "Apps connected with OAuth.",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "$ref": "#/components/schemas/Connection"
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/me/connections/{id}": {
   "delete": {
    "operationId": "disconnect",
    "summary": "Disconnect an app",
    "tags": [
     "Agents"
    ],
    "description": "Its tokens stop working at once.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The connection's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "204": {
      "description": "Disconnected."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/me/email-verification": {
   "post": {
    "operationId": "resendEmailVerification",
    "summary": "Email a new verification link",
    "tags": [
     "Account"
    ],
    "description": "Until an account confirms its email address, uploads, imports, upload links, share links, and board invites answer 403 with code email_unverified. Does nothing for a verified account. Up to 3 an hour.",
    "responses": {
     "204": {
      "description": "Sent, or already verified."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/me/exports": {
   "get": {
    "operationId": "listExports",
    "summary": "List library exports",
    "tags": [
     "Account"
    ],
    "responses": {
     "200": {
      "description": "Exports, newest first.",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "$ref": "#/components/schemas/Export"
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   },
   "post": {
    "operationId": "startExport",
    "summary": "Start a zip export of the library",
    "tags": [
     "Account"
    ],
    "description": "Built in the background; poll the list. A pending export is returned instead of starting another.",
    "responses": {
     "202": {
      "description": "The export.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Export"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/me/exports/{id}/download": {
   "get": {
    "operationId": "downloadExport",
    "summary": "Download a ready export",
    "tags": [
     "Account"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The export's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The zip.",
      "content": {
       "application/zip": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/me/private-tags": {
   "post": {
    "operationId": "addPrivateTags",
    "summary": "Add private tags to sounds",
    "tags": [
     "Sounds"
    ],
    "description": "Only this account sees them.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "ids": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "tags": {
          "type": "array",
          "items": {
           "type": "string"
          }
         }
        },
        "required": [
         "ids",
         "tags"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK"
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/me/sessions": {
   "delete": {
    "operationId": "signOutEverywhere",
    "summary": "Sign out every session",
    "tags": [
     "Account"
    ],
    "responses": {
     "204": {
      "description": "Signed out everywhere."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/me/storage": {
   "get": {
    "operationId": "storage",
    "summary": "Storage used against the plan's allowance",
    "tags": [
     "Account"
    ],
    "responses": {
     "200": {
      "description": "Usage.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Storage"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/openapi.json": {
   "get": {
    "operationId": "openAPI",
    "summary": "This document",
    "tags": [
     "Public"
    ],
    "responses": {
     "200": {
      "description": "OpenAPI 3.1."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/v1/accounts": {
   "post": {
    "operationId": "signUp",
    "summary": "Create an account from an invite link",
    "tags": [
     "Account"
    ],
    "description": "Sign-up is by invitation. invite is the token at the end of a board invite link (/b/<token>). The new account joins that board, is signed in with a session cookie, and gets an email to confirm its address. Until it confirms, it can't upload or share. Each network may create 5 accounts an hour.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "email": {
          "type": "string"
         },
         "password": {
          "type": "string"
         },
         "confirmPassword": {
          "type": "string"
         },
         "invite": {
          "type": "string",
          "description": "The 64-character token from a board invite link."
         }
        },
        "required": [
         "email",
         "password",
         "confirmPassword",
         "invite"
        ]
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "The account was created and signed in.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "email": {
           "type": "string"
          },
          "role": {
           "type": "string"
          },
          "emailVerified": {
           "type": "boolean"
          },
          "boardId": {
           "type": "integer",
           "description": "The board the invite was for."
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "The invite link is missing, expired, or revoked.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "409": {
      "description": "An account already has this email.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "429": {
      "description": "Too many accounts were created from this network in the last hour.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/v1/password-reset": {
   "post": {
    "operationId": "requestPasswordReset",
    "summary": "Email a password reset link",
    "tags": [
     "Account"
    ],
    "description": "Answers the same whether or not an account has the address. The link opens a page on the web to choose a new password, which signs the account out everywhere.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "email": {
          "type": "string"
         }
        },
        "required": [
         "email"
        ]
       }
      }
     }
    },
    "responses": {
     "202": {
      "description": "If an account has this address, a link is on its way."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/v1/requests": {
   "post": {
    "operationId": "requestSound",
    "summary": "Request a sound",
    "tags": [
     "Sounds"
    ],
    "description": "Adds a link to the request queue.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "url": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "note": {
          "type": "string"
         },
         "privateTags": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "sharedTags": {
          "type": "array",
          "items": {
           "type": "string"
          }
         }
        },
        "required": [
         "url"
        ]
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "The request."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/session": {
   "post": {
    "operationId": "signIn",
    "summary": "Sign in with an email and password",
    "tags": [
     "Account"
    ],
    "description": "Sets a session cookie. Scripts and agents use API keys or OAuth instead.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "email": {
          "type": "string"
         },
         "password": {
          "type": "string"
         }
        },
        "required": [
         "email",
         "password"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK"
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "security": []
   },
   "delete": {
    "operationId": "signOut",
    "summary": "Sign out this session",
    "tags": [
     "Account"
    ],
    "responses": {
     "204": {
      "description": "Signed out."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/shares/{token}": {
   "get": {
    "operationId": "sharedSound",
    "summary": "A shared sound's details",
    "tags": [
     "Public"
    ],
    "parameters": [
     {
      "name": "token",
      "in": "path",
      "required": true,
      "description": "From the share link.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Details.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "title": {
           "type": "string"
          },
          "contentType": {
           "type": "string"
          },
          "durationMs": {
           "type": "integer"
          }
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/v1/shares/{token}/audio": {
   "get": {
    "operationId": "sharedAudio",
    "summary": "A shared sound's audio",
    "tags": [
     "Public"
    ],
    "parameters": [
     {
      "name": "token",
      "in": "path",
      "required": true,
      "description": "From the share link.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The audio.",
      "content": {
       "audio/*": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/v1/shares/{token}/card.png": {
   "get": {
    "operationId": "sharedCard",
    "summary": "A shared sound's card",
    "tags": [
     "Public"
    ],
    "parameters": [
     {
      "name": "token",
      "in": "path",
      "required": true,
      "description": "From the share link.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "layout",
      "in": "query",
      "required": false,
      "description": "wide (default) or another layout.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "PNG.",
      "content": {
       "image/png": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/v1/sounds": {
   "get": {
    "operationId": "listSounds",
    "summary": "Search and list sounds",
    "tags": [
     "Sounds"
    ],
    "description": "The sounds this account owns or can see on its boards, a page at a time.",
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "required": false,
      "description": "Words to find in titles, tags, private tags, and transcripts.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "sort",
      "in": "query",
      "required": false,
      "description": "Order; title by default.",
      "schema": {
       "type": "string",
       "enum": [
        "title",
        "recent",
        "oldest",
        "shortest",
        "longest"
       ]
      }
     },
     {
      "name": "board",
      "in": "query",
      "required": false,
      "description": "Only sounds on this board.",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Sounds per page, 1 to 500; 100 by default.",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "cursor",
      "in": "query",
      "required": false,
      "description": "next from the previous page.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "drafts",
      "in": "query",
      "required": false,
      "description": "Set to 1 to list this account's drafts instead of its sounds.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "A page of sounds.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/SoundPage"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/sounds/tags": {
   "post": {
    "operationId": "addTags",
    "summary": "Add tags to sounds",
    "tags": [
     "Sounds"
    ],
    "description": "Owners only.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "ids": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "tags": {
          "type": "array",
          "items": {
           "type": "string"
          }
         }
        },
        "required": [
         "ids",
         "tags"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The updated sounds.",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "$ref": "#/components/schemas/Sound"
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/sounds/visibility": {
   "post": {
    "operationId": "setVisibility",
    "summary": "Set whether sounds are public",
    "tags": [
     "Sounds"
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "ids": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "public": {
          "type": "boolean"
         }
        },
        "required": [
         "ids",
         "public"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK"
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/sounds/{id}": {
   "get": {
    "operationId": "getSound",
    "summary": "Get a sound",
    "tags": [
     "Sounds"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The sound.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sound"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   },
   "patch": {
    "operationId": "updateSound",
    "summary": "Change a sound's title and tags",
    "tags": [
     "Sounds"
    ],
    "description": "Owners only. Send both title and tags.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "title": {
          "type": "string"
         },
         "tags": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "public": {
          "type": "boolean"
         }
        },
        "required": [
         "title",
         "tags"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The sound.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sound"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   },
   "delete": {
    "operationId": "deleteSound",
    "summary": "Delete a sound",
    "tags": [
     "Sounds"
    ],
    "description": "Owners only. Permanent.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "204": {
      "description": "Deleted."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "delete"
   }
  },
  "/v1/sounds/{id}/audio": {
   "get": {
    "operationId": "streamAudio",
    "summary": "Stream a sound's audio",
    "tags": [
     "Sounds"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The audio, with range support.",
      "content": {
       "audio/*": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/sounds/{id}/card": {
   "put": {
    "operationId": "updateCard",
    "summary": "Style a sound's card",
    "tags": [
     "Sharing"
    ],
    "description": "Owners only. Fields left out stay.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "color": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "subtitle": {
          "type": "string"
         },
         "branding": {
          "type": "boolean"
         }
        }
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The sound.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sound"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/sounds/{id}/card.mp4": {
   "get": {
    "operationId": "cardVideo",
    "summary": "The card as a video with the sound",
    "tags": [
     "Sharing"
    ],
    "description": "download=1 sends it as an attachment.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "MP4.",
      "content": {
       "video/mp4": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/sounds/{id}/card.png": {
   "get": {
    "operationId": "cardImage",
    "summary": "The card as an image",
    "tags": [
     "Sharing"
    ],
    "description": "preview=1 with color, title, subtitle, and branding draws unsaved changes (owners only).",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "layout",
      "in": "query",
      "required": false,
      "description": "square (default), wide, strip, or video.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "PNG.",
      "content": {
       "image/png": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/sounds/{id}/card/photo": {
   "put": {
    "operationId": "setCardPhoto",
    "summary": "Set the card photo",
    "tags": [
     "Sharing"
    ],
    "description": "Owners only. A JPEG, PNG, or HEIC up to 10 MB.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "image/*": {
       "schema": {
        "type": "string",
        "format": "binary"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The sound.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sound"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   },
   "delete": {
    "operationId": "removeCardPhoto",
    "summary": "Remove the card photo",
    "tags": [
     "Sharing"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The sound.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sound"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   },
   "get": {
    "operationId": "cardPhoto",
    "summary": "The card photo",
    "tags": [
     "Sharing"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "JPEG.",
      "content": {
       "image/jpeg": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/sounds/{id}/download": {
   "get": {
    "operationId": "downloadAudio",
    "summary": "Download a sound's audio",
    "tags": [
     "Sounds"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The audio as an attachment.",
      "content": {
       "audio/*": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/sounds/{id}/edit": {
   "post": {
    "operationId": "editSound",
    "summary": "Trim, cut, or split a sound",
    "tags": [
     "Editing"
    ],
    "description": "Anyone who can see a sound can save edits as new sounds in their own library; only the owner can overwrite.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "Idempotency-Key",
      "in": "header",
      "required": false,
      "description": "Retrying with the same key returns the first response instead of repeating the request, for a day.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/EditRequest"
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "The new sounds.",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "$ref": "#/components/schemas/Sound"
         }
        }
       }
      }
     },
     "200": {
      "description": "The overwritten sound.",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "$ref": "#/components/schemas/Sound"
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/sounds/{id}/gain": {
   "put": {
    "operationId": "setGain",
    "summary": "Set a sound's loudness",
    "tags": [
     "Editing"
    ],
    "description": "Owners and editors of its boards. Re-rendered in the background.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "gainDb": {
          "type": "number",
          "minimum": -12,
          "maximum": 12
         }
        },
        "required": [
         "gainDb"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The sound.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sound"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/sounds/{id}/share": {
   "post": {
    "operationId": "createShare",
    "summary": "Make a share link",
    "tags": [
     "Sharing"
    ],
    "description": "An unlisted link anyone can play.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "201": {
      "description": "The link.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "integer"
          },
          "url": {
           "type": "string"
          },
          "createdAt": {
           "type": "integer",
           "description": "Unix time in nanoseconds."
          }
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "share"
   }
  },
  "/v1/sounds/{id}/share/{shareId}": {
   "delete": {
    "operationId": "deleteShare",
    "summary": "Remove a share link",
    "tags": [
     "Sharing"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "shareId",
      "in": "path",
      "required": true,
      "description": "The link's ID.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "204": {
      "description": "Removed."
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "share"
   }
  },
  "/v1/sounds/{id}/transcribe": {
   "post": {
    "operationId": "retranscribe",
    "summary": "Transcribe a sound again",
    "tags": [
     "Editing"
    ],
    "description": "Owners only. Replaces a corrected transcript.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The sound.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sound"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/sounds/{id}/transcript": {
   "put": {
    "operationId": "setTranscript",
    "summary": "Correct a sound's transcript",
    "tags": [
     "Editing"
    ],
    "description": "Owners and editors of its boards. Transcription won't replace it.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "transcript": {
          "type": "string"
         }
        },
        "required": [
         "transcript"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The sound.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sound"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/sounds/{id}/waveform": {
   "get": {
    "operationId": "waveform",
    "summary": "A waveform image",
    "tags": [
     "Sounds"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "PNG.",
      "content": {
       "image/png": {
        "schema": {
         "type": "string",
         "format": "binary"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/sounds/{id}/words": {
   "get": {
    "operationId": "words",
    "summary": "When each transcript word is said",
    "tags": [
     "Editing"
    ],
    "description": "Approximate timings from the transcription server. timed is false until it has made them for the current audio. Long sounds are timed five minutes at a time; complete is false until the last part is done.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "The sound's ID.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The words.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "words": {
           "type": "array",
           "items": {
            "$ref": "#/components/schemas/Word"
           }
          },
          "timed": {
           "type": "boolean"
          },
          "complete": {
           "type": "boolean"
          }
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "read"
   }
  },
  "/v1/upload-links": {
   "post": {
    "operationId": "createUploadLink",
    "summary": "Make a one-time upload link",
    "tags": [
     "Agents"
    ],
    "description": "For agents that can run curl but can't send files. Works once, for an hour.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "title": {
          "type": "string"
         },
         "tags": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "boards": {
          "type": "array",
          "items": {
           "type": "integer"
          }
         }
        }
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "The link.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "url": {
           "type": "string"
          },
          "expiresAt": {
           "type": "integer",
           "description": "Unix time in nanoseconds."
          },
          "curl": {
           "type": "string"
          }
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  },
  "/v1/upload-links/{token}/{name}": {
   "put": {
    "operationId": "uploadThroughLinkPut",
    "summary": "Upload a file through an upload link",
    "tags": [
     "Agents"
    ],
    "description": "The body is the file; name becomes its title unless the link set one. No key needed: the link is the credential. curl -T file URL adds the name.",
    "parameters": [
     {
      "name": "token",
      "in": "path",
      "required": true,
      "description": "The link's token.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "name",
      "in": "path",
      "required": true,
      "description": "The file's name.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/octet-stream": {
       "schema": {
        "type": "string",
        "format": "binary"
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "The sound.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sound"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "security": []
   },
   "post": {
    "operationId": "uploadThroughLinkPost",
    "summary": "Upload a file through an upload link",
    "tags": [
     "Agents"
    ],
    "description": "The body is the file; name becomes its title unless the link set one. No key needed: the link is the credential. curl -T file URL adds the name.",
    "parameters": [
     {
      "name": "token",
      "in": "path",
      "required": true,
      "description": "The link's token.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "name",
      "in": "path",
      "required": true,
      "description": "The file's name.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/octet-stream": {
       "schema": {
        "type": "string",
        "format": "binary"
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "The sound.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sound"
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/v1/uploads": {
   "post": {
    "operationId": "upload",
    "summary": "Upload a sound",
    "tags": [
     "Sounds"
    ],
    "description": "An audio or video file up to 500 MB and 2 hours. Anything over a minute is saved as a draft to cut clips from. WAV and FLAC are stored as MP3; video keeps its audio and a frame as the card photo.",
    "parameters": [
     {
      "name": "Idempotency-Key",
      "in": "header",
      "required": false,
      "description": "Retrying with the same key returns the first response instead of repeating the request, for a day.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "multipart/form-data": {
       "schema": {
        "type": "object",
        "properties": {
         "file": {
          "type": "string",
          "format": "binary"
         },
         "title": {
          "type": "string"
         },
         "tags": {
          "type": "string",
          "description": "Comma-separated."
         },
         "boards": {
          "type": "string",
          "description": "Comma-separated board IDs; left out, the account's default boards."
         },
         "overwriteId": {
          "type": "string",
          "description": "Replace this sound's audio instead (owners only)."
         }
        },
        "required": [
         "file"
        ]
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "The sound.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sound"
        }
       }
      }
     },
     "409": {
      "description": "A sound with that title exists.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "string"
          },
          "duplicate": {
           "$ref": "#/components/schemas/Sound"
          }
         }
        }
       }
      }
     },
     "default": {
      "description": "An error.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    },
    "x-scope": "write"
   }
  }
 },
 "components": {
  "schemas": {
   "Error": {
    "type": "object",
    "properties": {
     "error": {
      "type": "string",
      "description": "What went wrong, in words meant for people."
     },
     "code": {
      "type": "string",
      "description": "A machine-readable reason, when there is one: email_unverified."
     }
    },
    "required": [
     "error"
    ]
   },
   "Card": {
    "type": "object",
    "properties": {
     "color": {
      "type": "string",
      "description": "One of the card palette's hex colors."
     },
     "title": {
      "type": "string",
      "description": "Replaces the sound's title on the card when set."
     },
     "subtitle": {
      "type": "string"
     },
     "branding": {
      "type": "boolean",
      "description": "Whether the card shows the audiochad label; only paid plans can turn it off."
     },
     "hasImage": {
      "type": "boolean"
     },
     "version": {
      "type": "integer",
      "description": "Increments whenever the card changes."
     }
    }
   },
   "Sound": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string"
     },
     "title": {
      "type": "string"
     },
     "tags": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "personalTags": {
      "type": "array",
      "items": {
       "type": "string",
       "description": "Private tags only this account sees."
      }
     },
     "filename": {
      "type": "string"
     },
     "contentType": {
      "type": "string"
     },
     "durationMs": {
      "type": "integer"
     },
     "sizeBytes": {
      "type": "integer"
     },
     "transcript": {
      "type": "string"
     },
     "transcriptSource": {
      "type": "string",
      "description": "\"auto\", \"manual\", or empty before transcription."
     },
     "transcriptModel": {
      "type": "string"
     },
     "favorite": {
      "type": "boolean"
     },
     "public": {
      "type": "boolean"
     },
     "loudnessLufs": {
      "type": "number"
     },
     "gainDb": {
      "type": "number",
      "description": "Loudness adjustment, -12 to 12 dB."
     },
     "audioVersion": {
      "type": "integer",
      "description": "Increments whenever the audio changes."
     },
     "processing": {
      "type": "array",
      "items": {
       "type": "string",
       "description": "Background jobs still running: loudness, transcribe, \u2026"
      }
     },
     "ownerId": {
      "type": "integer"
     },
     "boardIds": {
      "type": "array",
      "items": {
       "type": "integer"
      }
     },
     "access": {
      "type": "string",
      "description": "What this account may do: owner, editor, or viewer.",
      "enum": [
       "owner",
       "editor",
       "viewer"
      ]
     },
     "card": {
      "$ref": "#/components/schemas/Card"
     },
     "draft": {
      "type": "boolean",
      "description": "Set for uploads over a minute: private, deleted at draftExpiresAt, only for cutting clips from. Not in normal lists, never shared or on boards."
     },
     "draftExpiresAt": {
      "type": "integer",
      "description": "When the draft is deleted, in Unix nanoseconds."
     }
    },
    "required": [
     "id",
     "title",
     "tags",
     "durationMs",
     "audioVersion",
     "card"
    ]
   },
   "SoundPage": {
    "type": "object",
    "properties": {
     "sounds": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/Sound"
      }
     },
     "next": {
      "type": [
       "string",
       "null"
      ],
      "description": "Cursor for the next page, or null on the last."
     },
     "total": {
      "type": "integer",
      "description": "How many sounds match."
     }
    },
    "required": [
     "sounds",
     "next",
     "total"
    ]
   },
   "Word": {
    "type": "object",
    "properties": {
     "text": {
      "type": "string"
     },
     "startMs": {
      "type": "integer"
     },
     "endMs": {
      "type": "integer"
     }
    },
    "required": [
     "text",
     "startMs",
     "endMs"
    ]
   },
   "Board": {
    "type": "object",
    "properties": {
     "id": {
      "type": "integer"
     },
     "name": {
      "type": "string"
     },
     "ownerId": {
      "type": "integer"
     },
     "role": {
      "type": "string",
      "description": "This account's role.",
      "enum": [
       "owner",
       "editor",
       "viewer"
      ]
     },
     "soundCount": {
      "type": "integer"
     },
     "memberCount": {
      "type": "integer"
     },
     "createdAt": {
      "type": "integer",
      "description": "Unix time in nanoseconds."
     }
    }
   },
   "BoardMember": {
    "type": "object",
    "properties": {
     "userId": {
      "type": "integer"
     },
     "email": {
      "type": "string"
     },
     "role": {
      "type": "string",
      "enum": [
       "owner",
       "editor",
       "viewer"
      ]
     },
     "addedAt": {
      "type": "integer",
      "description": "Unix time in nanoseconds."
     }
    }
   },
   "BoardInvite": {
    "type": "object",
    "properties": {
     "id": {
      "type": "integer"
     },
     "boardId": {
      "type": "integer"
     },
     "role": {
      "type": "string",
      "enum": [
       "editor",
       "viewer"
      ]
     },
     "createdAt": {
      "type": "integer",
      "description": "Unix time in nanoseconds."
     },
     "expiresAt": {
      "type": "integer",
      "description": "Unix time in nanoseconds."
     }
    }
   },
   "APIKey": {
    "type": "object",
    "properties": {
     "id": {
      "type": "integer"
     },
     "name": {
      "type": "string"
     },
     "prefix": {
      "type": "string",
      "description": "The start of the token, to tell keys apart."
     },
     "scopes": {
      "type": "array",
      "items": {
       "type": "string",
       "enum": [
        "read",
        "write",
        "delete",
        "share"
       ]
      }
     },
     "createdAt": {
      "type": "integer",
      "description": "Unix time in nanoseconds."
     },
     "lastUsedAt": {
      "type": "integer",
      "description": "Unix time in nanoseconds."
     }
    }
   },
   "Connection": {
    "type": "object",
    "properties": {
     "id": {
      "type": "integer"
     },
     "clientName": {
      "type": "string"
     },
     "clientUri": {
      "type": "string"
     },
     "scopes": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "createdAt": {
      "type": "integer",
      "description": "Unix time in nanoseconds."
     },
     "lastUsedAt": {
      "type": "integer",
      "description": "Unix time in nanoseconds."
     }
    }
   },
   "Activity": {
    "type": "object",
    "properties": {
     "id": {
      "type": "integer"
     },
     "at": {
      "type": "integer",
      "description": "Unix time in nanoseconds."
     },
     "actorKind": {
      "type": "string",
      "enum": [
       "session",
       "api_key",
       "oauth",
       "upload_link"
      ]
     },
     "actorName": {
      "type": "string"
     },
     "action": {
      "type": "string"
     },
     "soundId": {
      "type": "string"
     }
    }
   },
   "Export": {
    "type": "object",
    "properties": {
     "id": {
      "type": "integer"
     },
     "state": {
      "type": "string",
      "enum": [
       "pending",
       "ready",
       "failed"
      ]
     },
     "sizeBytes": {
      "type": "integer"
     },
     "error": {
      "type": "string"
     },
     "createdAt": {
      "type": "integer",
      "description": "Unix time in nanoseconds."
     },
     "finishedAt": {
      "type": "integer",
      "description": "Unix time in nanoseconds."
     }
    }
   },
   "Storage": {
    "type": "object",
    "properties": {
     "sounds": {
      "type": "integer"
     },
     "servedBytes": {
      "type": "integer"
     },
     "originalBytes": {
      "type": "integer"
     },
     "photoBytes": {
      "type": "integer"
     },
     "usedBytes": {
      "type": "integer"
     },
     "quotaBytes": {
      "type": "integer",
      "description": "The plan's allowance; not enforced yet."
     },
     "plan": {
      "type": "string"
     }
    }
   },
   "EditRequest": {
    "type": "object",
    "properties": {
     "mode": {
      "type": "string",
      "description": "trim keeps startMs\u2013endMs; remove cuts it out; split saves segments as new sounds.",
      "enum": [
       "trim",
       "remove",
       "split"
      ]
     },
     "action": {
      "type": "string",
      "description": "overwrite replaces the sound's audio (owners only); new saves new sounds.",
      "enum": [
       "new",
       "overwrite"
      ]
     },
     "startMs": {
      "type": "integer"
     },
     "endMs": {
      "type": "integer"
     },
     "title": {
      "type": "string",
      "description": "Title of the new sound, for trim and remove saved as new."
     },
     "segments": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "title": {
         "type": "string"
        },
        "startMs": {
         "type": "integer"
        },
        "endMs": {
         "type": "integer"
        }
       }
      }
     },
     "gainDb": {
      "type": "number",
      "description": "Loudness for the edited audio."
     },
     "repeat": {
      "type": "integer",
      "description": "Play a trimmed selection up to 3 times in a row.",
      "minimum": 1,
      "maximum": 3
     },
     "keepDraft": {
      "type": "boolean",
      "description": "When cutting from a draft, keep it to cut more; otherwise saving deletes it."
     }
    },
    "required": [
     "mode",
     "action"
    ],
    "description": "New sounds are a minute at most. Drafts can't be overwritten."
   }
  },
  "securitySchemes": {
   "apiKey": {
    "type": "http",
    "scheme": "bearer",
    "description": "A personal API key, ac_\u2026, from Account."
   },
   "oauth": {
    "type": "oauth2",
    "description": "For apps. Register with /oauth/register or use a client ID metadata document; PKCE with S256 is required.",
    "flows": {
     "authorizationCode": {
      "authorizationUrl": "https://soundboard.rfelix13.com/oauth/authorize",
      "tokenUrl": "https://soundboard.rfelix13.com/oauth/token",
      "refreshUrl": "https://soundboard.rfelix13.com/oauth/token",
      "scopes": {
       "read": "See your sounds",
       "write": "Add and edit sounds",
       "share": "Share sounds",
       "delete": "Delete sounds"
      }
     }
    }
   },
   "session": {
    "type": "apiKey",
    "in": "cookie",
    "name": "soundboard_friend",
    "description": "The web and iPhone app's session (soundboard_admin for admins)."
   }
  }
 }
}