---
updatedAt: 2026-09-07T11:12:49.000Z
agentTools:
  projectIndex: https://developers.slite.com/llms.txt
---

# Update note owner

Update the owner of a note, it can be a user or a group

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "components": {
    "schemas": {
      "PublicApiAuthError": {
        "properties": {
          "message": {
            "type": "string",
            "enum": [
              "Invalid apiKey"
            ],
            "nullable": false
          },
          "id": {
            "type": "string",
            "enum": [
              "auth/unauthorized"
            ],
            "nullable": false
          }
        },
        "required": [
          "message",
          "id"
        ],
        "type": "object"
      },
      "PublicApiError": {
        "properties": {
          "message": {
            "type": "string"
          },
          "id": {
            "type": "string"
          }
        },
        "required": [
          "message",
          "id"
        ],
        "type": "object"
      },
      "FieldErrors": {
        "properties": {},
        "type": "object",
        "additionalProperties": {
          "properties": {
            "value": {},
            "message": {
              "type": "string"
            }
          },
          "required": [
            "message"
          ],
          "type": "object"
        }
      },
      "PublicApiFieldValidationError": {
        "properties": {
          "details": {
            "$ref": "#/components/schemas/FieldErrors"
          },
          "message": {
            "type": "string",
            "enum": [
              "Validation Failed"
            ],
            "nullable": false
          },
          "id": {
            "type": "string",
            "enum": [
              "field-validation"
            ],
            "nullable": false
          }
        },
        "required": [
          "message",
          "id"
        ],
        "type": "object"
      },
      "PublicApiRateLimitError": {
        "properties": {
          "message": {
            "type": "string",
            "enum": [
              "You've reached the api rate limit. Please wait and retry later."
            ],
            "nullable": false
          },
          "id": {
            "type": "string",
            "enum": [
              "rate-limit"
            ],
            "nullable": false
          }
        },
        "required": [
          "message",
          "id"
        ],
        "type": "object"
      },
      "PublicApiReviewState": {
        "enum": [
          "Verified",
          "Outdated",
          "VerificationRequested",
          "VerificationExpired"
        ],
        "type": "string"
      },
      "NoteOwner": {
        "properties": {
          "groupId": {
            "type": "string",
            "description": "Group id of the owner (if owner is a group)"
          },
          "userId": {
            "type": "string",
            "description": "User id of the owner (if owner is a user)"
          }
        },
        "type": "object",
        "description": "Owner of the note for review purposes.\nEither userId or groupId will be set, but not both."
      },
      "Note": {
        "properties": {
          "owner": {
            "$ref": "#/components/schemas/NoteOwner",
            "description": "Owner of the note for review purposes.\nEither userId or groupId will be set, but not both.\nIf no owner is set, this field will be omitted."
          },
          "reviewState": {
            "$ref": "#/components/schemas/PublicApiReviewState",
            "description": "Review state of the note\nCan be Verified, Outdated, VerificationRequested or VerificationExpired"
          },
          "archivedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Date of the archiving of the note (null if not archived)"
          },
          "lastEditedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date of the last edition of the note"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date of the last update of the note"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date of the creation of the note"
          },
          "columns": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "description": "If note is in a collection, it will contain its column names"
          },
          "attributes": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "description": "If note is in a collection, it will contain its attributes ordered\nby column"
          },
          "url": {
            "type": "string",
            "description": "Url to the note"
          },
          "listPosition": {
            "type": "number",
            "format": "double",
            "nullable": true,
            "description": "Position of the note among its siblings, matching the order shown in the\nSlite sidebar. Higher values come first (top of the sidebar). By default\nit is seeded from the creation date, so freshly created docs appear at the\ntop; manual reordering overrides it. Combine with\n`orderBy=listPosition_DESC` on the children endpoint to reproduce the\nsidebar order. Writable via the `listPosition` body parameter of the\ncreate and update endpoints."
          },
          "parentNoteId": {
            "type": "string",
            "nullable": true,
            "description": "Parent note id of the current note.\nIt can be null if it's a root note."
          },
          "iconColor": {
            "type": "string",
            "nullable": true,
            "description": "Optional icon color for the note."
          },
          "iconShape": {
            "type": "string",
            "nullable": true,
            "description": "Optional icon identifier for the note."
          },
          "title": {
            "type": "string",
            "description": "Title of the note"
          },
          "id": {
            "type": "string",
            "description": "Id of the note"
          }
        },
        "required": [
          "archivedAt",
          "lastEditedAt",
          "updatedAt",
          "createdAt",
          "url",
          "parentNoteId",
          "title",
          "id"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "bearer": {
        "type": "http",
        "scheme": "bearer",
        "description": "API keys can be generated under Settings > API"
      }
    }
  },
  "info": {
    "title": "Public Slite api",
    "version": "1",
    "description": "Access your Slite documents, search, create, update...",
    "license": {
      "name": "private"
    },
    "contact": {
      "name": "Slite"
    }
  },
  "paths": {
    "/notes/{noteId}/owner": {
      "put": {
        "operationId": "updateNoteOwner",
        "responses": {
          "200": {
            "description": "Ok",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Note"
                },
                "examples": {
                  "Example 1": {
                    "value": {
                      "id": "noteId",
                      "createdAt": "2024-01-01T00:00:00.000Z",
                      "updatedAt": "2024-01-01T00:00:00.000Z",
                      "lastEditedAt": "2024-01-02T00:00:00.000Z",
                      "parentNoteId": "parentNoteId",
                      "title": "Slite interconnection",
                      "url": "https://slite.slite.com/api/s/noteId/Slite%20interconnection",
                      "archivedAt": null,
                      "listPosition": 308866713
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Invalid authentication",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiAuthError"
                }
              }
            }
          },
          "422": {
            "description": "Input validation error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiFieldValidationError"
                }
              }
            }
          },
          "429": {
            "description": "Rate limitation error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiRateLimitError"
                }
              }
            }
          },
          "default": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiError"
                }
              }
            }
          }
        },
        "description": "Update the owner of a note, it can be a user or a group",
        "summary": "Update note owner",
        "security": [
          {
            "bearer": [
              "write"
            ]
          }
        ],
        "parameters": [
          {
            "description": "Note id to update",
            "in": "path",
            "name": "noteId",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "noteId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "userId": {
                    "type": "string",
                    "description": "User id to set as the owner of the note",
                    "example": [
                      "userId"
                    ]
                  },
                  "groupId": {
                    "type": "string",
                    "description": "Group id to set as the owner of the note",
                    "example": [
                      "groupId"
                    ]
                  }
                },
                "type": "object"
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.slite.com/v1"
    }
  ]
}
```