How to upload/Migrate XLSForm via API directly into an organization/project space instead of “My Projects”?

User Support Data Management
,
1

Hello KoboToolbox team,

I am using the KoboToolbox API v2 to upload converted XLSForms into Kobo. The upload works successfully, but the forms are created under the default My Projects space of the API token user.

In the Kobo UI, the account has multiple project spaces in the dropdown, for example:

My Projects
xyz Projects

In another account, the spaces are named by country/location, for example:

My Projects
country A space

Currently my script creates the asset like this:

POST /api/v2/assets/?format=json

{
  "name": "Form Name",
  "asset_type": "survey"
}

Then it imports the XLSForm using:

POST /api/v2/imports/?format=json
destination = /api/v2/assets/{asset_uid}/

This uploads correctly, but always into the default My Projects area.

I can see the organization through:

GET /api/v2/organizations/

Example organization result:

name: name_of_organization
id: org_unique_id

My question is:

How can I create or upload an XLSForm directly into a specific project space such as Trocaire Projects or a country/location space, instead of the token user’s default My Projects?

Specifically:

  1. Is there a field such as owner, organization, parent, or another parameter that should be passed when creating the asset?

  2. Should assets be created through an organization-specific endpoint?

  3. If the project spaces are country/location spaces, are these separate Kobo users, organization teams, or collections?

  4. Is it possible to move an already-created asset from My Projects into another project space using the API?

Any example API request would be very helpful.

Thank you.

3

Solved!

the Kobo API token belongs to / has access under the organization. Kobo creates the project under the token owner, and that uploaded form is also visible in the organization project space.

4

@meetthkaer, yes you will need to use the correct Token on where you would like to upload your form. If you use your token, you will upload the XLSForm to your account. And if you use the admin’s token you will upload the same XLSForm to the admin account. :folded_hands: