Sign in
Manage projects and library content

Changed on

Update or connect a user's asset

Updates a project or connect project's data from this project to other projects

When Data sharing:

fields: Optional. List of questions whose responses will be shared. If missing or empty, all responses will be shared. Questions must be identified by full group path separated by slashes, e.g. group/subgroup/question_name.

patch/api/v2/assets/{uid_asset}/

Request

  • The document declares no server URL.
  • Auth: one of:
    • HTTP basic
    • API key in header Authorization

Path parameters

uid_assetstring required

Request body

OR
OR

Response

urlstring uri required
ownerstring uri required
owner__usernamestring required

Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.

parentstring uri nullable
asset_type'text' | 'empty' | 'question' | 'block' | 'survey' | 'template' | 'collection' required
  • text - text
  • empty - empty
  • question - question
  • block - block
  • survey - survey
  • template - template
  • collection - collection
date_createdstring date-time
date_modifiedstring date-time
date_deployedstring date-time nullable
version_idstring nullable required
version__content_hashstring nullable required
version_countinteger required
has_deploymentboolean required
deployed_version_idstring nullable required
deployment__linksobject required
deployment__activeboolean required
deployment__submission_countinteger required
deployment__last_submission_timestring date-time nullable required
deployment__encryptedboolean required
deployment__uuidstring nullable required
deployment_status'archived' | 'deployed' | 'draft' | '-' required
  • archived - Archived
  • deployed - Deployed
  • draft - Draft
  • - - -
report_customobject
map_customobject
xform_linkstring uri required
hooks_linkstring uri required
tag_stringstring
uidstring required
kindstring required
xls_linkstring uri required
namestring
exportsstring uri required
datastring uri required
subscribers_countinteger required
statusstring required
access_typesstring[] nullable required
paired_datastring uri required
project_ownershipobject nullable required
owner_labelstring required
last_modified_bystring nullable required
created_bystring nullable required

Example response

{
  "url": "https://kf.kobotoolbox.org/api/v2/assets/aBeA23YCYjkGTFvYVHuAyU/",
  "owner": "https://kf.kobotoolbox.org/api/v2/users/bob/",
  "parent": "https://kf.kobotoolbox.org/api/v2/assets/a3C9wWefqZVkChNLKqqXVZ/",
  "deployed_versions": {
    "results": [
      {
        "url": "https://kf.kobotoolbox.org/api/v2/assets/aBeA23YCYjkGTFvYVHuAyU/versions/vBeA23YCYjkGTFvYVHuAyU/"
      }
    ]
  },
  "xform_link": "https://kf.kobotoolbox.org/api/v2/assets/aBeA23YCYjkGTFvYVHuAyU/xform/",
  "hooks_link": "https://kf.kobotoolbox.org/api/v2/assets/aBeA23YCYjkGTFvYVHuAyU/hooks/",
  "xls_link": "https://kf.kobotoolbox.org/api/v2/assets/aBeA23YCYjkGTFvYVHuAyU.xls",
  "exports": "https://kf.kobotoolbox.org/api/v2/assets/aBeA23YCYjkGTFvYVHuAyU/exports/",
  "data": "https://kf.kobotoolbox.org/api/v2/assets/aBeA23YCYjkGTFvYVHuAyU/data/",
  "paired_data": "https://kf.kobotoolbox.org/api/v2/assets/aBeA23YCYjkGTFvYVHuAyU/paired-data/"
}

Changes

  • v27f81278fee5aRevision changes
    • breaking

      the response property // became nullable for the status

  • v241cb6ede9360Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status