Sign in
Datamates

Update Datamate

patch/datamates/{datamate_id}

Path parameters

datamate_idinteger required

Request body

namestring nullable
descriptionstring nullable
memory_enabledboolean nullable
knowledge_engine_enabledboolean nullable
privacy'private' | 'public' | 'restricted'

Sharing modes for a workspace.

Deliberately local rather than adding a member to the shared PrivacySetting, which is imported by five resources (datamates, knowledge bases, notebooks, query bookmarks, custom skills). restricted is meaningless for the other four, and widening the shared enum would make it a legal value there.

The two overlapping values keep identical strings, so rows written before this existed, and every cross-file read that compares against PrivacySetting.PUBLIC.value, still work.

Reviewers found this argument was made and then broken in the same diff: four CustomSkill schemas were swapped to this enum, which made restricted a legal value for a resource with no grant table behind it — _visible_to (crud/custom_skills.py) matches owner-or-public only, and custom_skills.privacy has no CHECK, so such a skill would persist and be permanently invisible to everyone but its creator. Custom skills are back on PrivacySetting; keep them there until they implement sharing.

knowledge_basesinteger[] nullable

Response

Successful Response

Changes

Changed in 2 of the 55 revisions of this API.213

  • eebfc2f234e11See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 68 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 51aa5d004c49212See the full diff
    • ▲

      removed from the request property anyOf list

      request-property-any-of-removed

    • ▲

      removed the media type application/json for the response with the status

      response-media-type-removed

    • ●

      added the new restricted enum value to the / response property for the response status

      response-property-enum-value-added

    • ○

      added to the request property anyOf list

      request-property-any-of-added

    • ○

      removed the non-success response with the status

      response-non-success-status-removed