> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a template File Request

export const Link = ({href, children, className, ...props}) => {
  const localizedHref = localizeLink(href);
  return <a href={localizedHref} className={className} {...props}>
      {children}
    </a>;
};

export const MultiRelatedLinks = ({sections = []}) => {
  if (!sections || sections.length === 0) {
    return null;
  }
  return <div className="space-y-8">
      {sections.map((section, index) => <RelatedLinks key={index} title={section.title} items={section.items} />)}
    </div>;
};

export const RelatedLinks = ({title, items = []}) => {
  const getBadgeClass = badge => {
    if (!badge) return "badge-default";
    const badgeType = badge.toLowerCase().replace(/\s+/g, "-");
    return `badge-${badge === "ガイド" ? "guide" : badgeType}`;
  };
  if (!items || items.length === 0) {
    return null;
  }
  return <div className="my-8">
      {}
      <h3 className="text-sm font-bold uppercase tracking-wider mb-4">{title}</h3>

      {}
      <div className="flex flex-col gap-3">
        {items.map((item, index) => <a key={index} href={item.href} className="py-2 px-3 rounded related_link hover:bg-[#f2f2f2] dark:hover:bg-[#111827] flex items-center gap-3 group no-underline hover:no-underline border-b-0">
            {}
            <span className={`px-2 py-1 rounded-full text-xs font-semibold uppercase tracking-wide flex-shrink-0 ${getBadgeClass(item.badge)}`}>
              {item.badge}
            </span>

            {}
            <span className="text-base">{item.label}</span>
          </a>)}
      </div>
    </div>;
};

Currently, the API only allows the creation of new file requests by copying an
existing file request associated to another folder. Please check our below
guide on creating a template folder with a template file request.

## 1. Template folder

First off, create a template folder that you can associate the template file
request to. This can be any folder really, but we recommend using a
folder that is only used for this purpose.

A folder can be created through the Box web or mobile interface, or through the
<Link href="/reference/post-folders">`POST /folders`</Link> API.

<Note>
  When using server-side JWT authentication, we recommend creating folder that
  is owned by the application's
  <Link href="/platform/user-types/#service-account">Service Account</Link>. This way,
  the folder can't be accidentally deleted by a regular Box user.
</Note>

## 2. Template file request

To create a file request, navigate to the template folder in the web app an
d click the 3 dots at the top of the page. Then, select **File Request** from
the menu.

<Frame center shadow>
  <img src="https://mintcdn.com/box/_tECS-SYBYV9K-kZ/images/guides/file-requests/create.png?fit=max&auto=format&n=_tECS-SYBYV9K-kZ&q=85&s=d720b4e17ba7824ec59966a35fe12493" alt="Create a file request" width="800" height="432" data-path="images/guides/file-requests/create.png" />
</Frame>

In the next configuration panel, click the **Edit** button to visit the file
request configuration page.

<Frame center shadow>
  <img src="https://mintcdn.com/box/_tECS-SYBYV9K-kZ/images/guides/file-requests/edit.png?fit=max&auto=format&n=_tECS-SYBYV9K-kZ&q=85&s=73e0259bd31fff37f004c455f071dc34" alt="Edit a file request" width="800" height="575" data-path="images/guides/file-requests/edit.png" />
</Frame>

On the configuration page, you can set configure the title and description,
before saving the page.

This page will also have the ID of the file request in the URL. Make a note of
the URL as the number at the end is the file request's ID, which you will need
when working with the API.

```sh theme={null}
https://*.app.box.com/filerequest/2338423584
```

<Warning>
  If your template folder belongs to a JWT user, you will need to
  <Link href="/reference/post-collaborations">invite</Link> a managed Box user to the folder before
  it can be seen in the web app. Invite yourself to the folder to allow yourself
  to add a file request to the folder via the app.
</Warning>

## 3. Using a template

A template file request can be used to create new copies using the
<Link href="/reference/post-file-requests-id-copy">`POST /file-requests/:id/copy`</Link>
API. With the ID of a new folder in hand, you can copy the existing
request, including its title, description and form-configuration
to a new folder <Link href="/guides/file-requests/copy">with one API call</Link>.

<RelatedLinks
  title="RELATED APIS"
  items={[
{ label: translate("Copy file request"), href: "/reference/post-file-requests-id-copy", badge: "POST" }
]}
/>

<RelatedLinks
  title="RELATED GUIDES"
  items={[
{ label: translate("Copy a File Request"), href: "/guides/file-requests/copy", badge: "GUIDE" }
]}
/>
