action stream_io_api_get_permission {
  label: "Get permission"
  description: "Gets custom permission"
  provider: stream_io_api
  method: GET
  path: "/permissions/{id}"
  encoding: json
  input: {
    type: "object"
    properties: {
      id: {
        type: "string"
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["duration", "permission"]
    properties: {
      duration: {
        type: "string"
        description: "Duration of the request in human-readable format"
      }
      permission: {
        type: "object"
        required: ["action", "custom", "description", "id", "level", "name", "owner", "same_team", "tags"]
        properties: {
          action: {
            type: "string"
            description: "Action name this permission is for (e.g. SendMessage)"
          }
          condition: {
            type: "object"
            description: "MongoDB style condition which decides whether or not the permission is granted"
          }
          custom: {
            type: "boolean"
            description: "Whether this is a custom permission or built-in"
          }
          description: {
            type: "string"
            description: "Description of the permission"
          }
          id: {
            type: "string"
            description: "Unique permission ID"
          }
          level: {
            type: "string"
            description: "Level at which permission could be applied (app or channel)"
            enum: ["app", "channel"]
          }
          name: {
            type: "string"
            description: "Name of the permission"
          }
          owner: {
            type: "boolean"
            description: "Whether this permission applies to resource owner or not"
          }
          same_team: {
            type: "boolean"
            description: "Whether this permission applies to teammates (multi-tenancy mode only)"
          }
          tags: {
            type: "array"
            description: "List of tags of the permission"
            items: {
              type: "string"
            }
          }
        }
      }
    }
  }
}