PATCH /asset-permissions-api/v1/assets/permissions — asset-permissions-api/v1

Grant a subject permission to multiple assets.

Authorization is required to grant permissions to the subject and asset IDs in the request.

Endpoint

Method: PATCH

Path: /asset-permissions-api/v1/assets/permissions

Servers:

https://apis.roblox.com

Request Body

{
  "content": {
    "application/json-patch+json": {
      "schema": {
        "$ref": "#/components/schemas/BatchGrantPermissionsRequest"
      }
    },
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BatchGrantPermissionsRequest"
      }
    },
    "text/json": {
      "schema": {
        "$ref": "#/components/schemas/BatchGrantPermissionsRequest"
      }
    },
    "application/*+json": {
      "schema": {
        "$ref": "#/components/schemas/BatchGrantPermissionsRequest"
      }
    }
  }
}

Responses

Status	Description
200	OK
400	Bad Request
403	Forbidden
500	Internal Server Error

{
  "200": {
    "description": "OK",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/BatchGrantPermissionsResponse"
        }
      }
    }
  },
  "400": {
    "description": "Bad Request",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/ErrorResponse"
        }
      }
    }
  },
  "403": {
    "description": "Forbidden",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/ErrorResponse"
        }
      }
    }
  },
  "500": {
    "description": "Internal Server Error",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/ErrorResponse"
        }
      }
    }
  }
}

Authentication

{
  "security": [
    {
      "roblox-legacy-cookie": []
    },
    {
      "roblox-api-key": []
    }
  ],
  "securitySchemes": {
    "roblox-legacy-cookie": {
      "type": "apiKey",
      "description": "A browser cookie that represents the identity of a Roblox user. DO NOT SHARE THIS. Sharing this will allow someone to log in as you and to steal your Robux and items. When possible, use API keys with the x-api-key header or OAuth 2.0 instead for authentication.",
      "in": "cookie",
      "name": ".ROBLOSECURITY"
    },
    "roblox-api-key": {
      "type": "apiKey",
      "description": "A configurable key that allows granular access to Roblox resources. See https://create.roblox.com/docs/cloud/auth/api-keys for more information.",
      "in": "header",
      "name": "x-api-key"
    }
  }
}

Complete Operation Definition

{
  "tags": [
    "AssetPermissions"
  ],
  "summary": "Grant a subject permission to multiple assets.\n            \nAuthorization is required to grant permissions to the subject and asset IDs in the request.",
  "requestBody": {
    "content": {
      "application/json-patch+json": {
        "schema": {
          "$ref": "#/components/schemas/BatchGrantPermissionsRequest"
        }
      },
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/BatchGrantPermissionsRequest"
        }
      },
      "text/json": {
        "schema": {
          "$ref": "#/components/schemas/BatchGrantPermissionsRequest"
        }
      },
      "application/*+json": {
        "schema": {
          "$ref": "#/components/schemas/BatchGrantPermissionsRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/BatchGrantPermissionsResponse"
          }
        }
      }
    },
    "400": {
      "description": "Bad Request",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "Forbidden",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "Internal Server Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  },
  "x-roblox-stability": "BETA",
  "x-roblox-rate-limits": {
    "perApiKeyOwner": {
      "period": "MINUTE",
      "maxInPeriod": 100
    }
  },
  "x-roblox-scopes": [
    {
      "name": "asset-permissions:write"
    }
  ],
  "x-roblox-engine-usability": {
    "apiKeyWithHttpService": false
  },
  "security": [
    {
      "roblox-legacy-cookie": []
    },
    {
      "roblox-api-key": []
    }
  ]
}