Home
Content Management API
Main resources
Upload-related
Site Search
Environments
UI
Workflows
Async jobs
Roles & permissions
Webhooks
Hosting & CI integrations
Subscription
Enterprise
    Show examples in:
    Fork an existing environment

    Query parameters

    immediate_return  boolean  Optional

    Whether the call should immediately return a pending environment, or wait for the completion of the fork

    fast  boolean  Optional

    Performing a fast fork reduces processing time, but it also prevents writing to the source environment during the process

    force  boolean  Optional

    Force the start of fast fork, even if there are collaborators editing some records

    Parameters

    id  string  Required
    The ID of the forked environment

    Returns

    Returns a environment resource object.

    Examples

    Example code:
    import { buildClient } from '@datocms/cma-client-node';
    async function run() {
      const client = buildClient({ apiToken: '<YOUR_API_TOKEN>' });
      
      const environmentId = 'main';
      
      const environment = await client.environments.fork(environmentId, {
        id: 'my-sandbox-env'
      }, {
        immediate_return: true,
        fast: true,
        force: true
      });
      
      console.log(environment);
    }
    run();
    Returned output:
    {
      id: 'main',
      meta: {
        status: 'ready',
        fork_completion_percentage: 95,
        read_only_mode: true,
        created_at: '2020-04-21T07:57:11.124Z',
        last_data_change_at: '2020-04-21T07:57:11.124Z',
        primary: true,
        forked_from: 'main'
      }
    }
    Questions?
    We're always happy to help with code or other questions you might have. Search our documentation, forum, contact support, or connect with our sales team. You can chat live with other developers in our Slack channel.