---
updatedAt: 2026-05-27T05:24:21.000Z
agentTools:
  projectIndex: https://developers.toriihq.com/llms.txt
---

# Update app

Update app fields including all custom fields defined via [custom Application Details](https://app.toriihq.com/team/settings/appDetails)<br/><br/>
<p><ul><li>Rate limit: 100 requests per minute</li></ul></p>

# OpenAPI definition

```json
{
  "servers": [
    {
      "url": "https://api.toriihq.com/v1.0"
    }
  ],
  "info": {
    "title": "Torii API Documentation",
    "version": "v1.0",
    "description": "The Torii API provides an easy way to integrate your data in Torii with any external system. The API closely follows REST semantics, uses JSON to encode objects, and relies on standard HTTP codes to signal operation outcomes. Torii APIs consist of both proprietary and SCIM 2.0 APIs."
  },
  "x-readme": {
    "explorer-enabled": true
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "tags": [
    {
      "name": "Apps"
    }
  ],
  "openapi": "3.0.0",
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-bearer-format": "bearer"
      }
    },
    "schemas": {
      "AppPayload": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Unique identifier",
            "example": 1000,
            "minimum": 1
          },
          "isHidden": {
            "type": "boolean",
            "example": false
          },
          "name": {
            "type": "string",
            "example": "Salesforce",
            "maxLength": 255
          },
          "state": {
            "type": "string",
            "description": "Application state",
            "example": "discovered"
          },
          "url": {
            "type": "string",
            "example": "https://example.com"
          },
          "category": {
            "type": "string",
            "example": "Developer Tools",
            "maxLength": 256
          },
          "description": {
            "type": "string",
            "example": "Awesome application",
            "maxLength": 1024
          },
          "tags": {
            "type": "string",
            "example": "DevOps,Human Resource"
          }
        }
      },
      "UpdateApp": {
        "type": "object",
        "description": "Update app fields including all fields from /apps/fields",
        "properties": {
          "owner": {
            "type": "integer",
            "description": "Deprecated. Use primaryOwner instead",
            "example": 1000,
            "nullable": true,
            "minimum": 1,
            "deprecated": true
          },
          "isHidden": {
            "type": "boolean",
            "example": false
          },
          "name": {
            "type": "string",
            "example": "Salesforce",
            "maxLength": 255
          },
          "state": {
            "type": "string",
            "description": "Application state",
            "example": "discovered"
          },
          "url": {
            "type": "string",
            "example": "https://example.com"
          },
          "category": {
            "type": "string",
            "example": "Developer Tools",
            "maxLength": 256
          },
          "description": {
            "type": "string",
            "example": "Awesome application",
            "maxLength": 1024
          },
          "tags": {
            "type": "string",
            "example": "DevOps,Human Resource",
            "maxLength": 100
          }
        }
      },
      "UpdatedAppWithAllExistingAppFields": {
        "type": "object",
        "description": "Updated app with all existing app fields",
        "properties": {
          "app": {
            "$ref": "#/components/schemas/AppPayload"
          }
        }
      }
    }
  },
  "paths": {
    "/apps/{idApp}": {
      "put": {
        "summary": "Update app",
        "operationId": "putAppsIdapp",
        "description": "Update app fields including all custom fields defined via [custom Application Details](https://app.toriihq.com/team/settings/appDetails)<br/><br/>\n<p><ul><li>Rate limit: 100 requests per minute</li></ul></p>",
        "parameters": [
          {
            "name": "idApp",
            "in": "path",
            "schema": {
              "type": "integer",
              "description": "Unique app identifier",
              "example": 1000,
              "minimum": 1,
              "maximum": 2147483647
            },
            "description": "Unique app identifier",
            "required": true
          }
        ],
        "tags": [
          "Apps"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateApp"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated app with all existing app fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UpdatedAppWithAllExistingAppFields"
                }
              }
            }
          }
        }
      }
    }
  }
}
```